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How to Use This Manual 


Manual Objectives 


This manual describes how to write reports with DATATRIEVE-11. It illus- 
trates the use of the DATATRIEVE-11 Report Writer. 


Audience 


You should use this manual if you want to produce reports using data managed 
by DATATRIEVE-11. The manual assumes that you have read or are familiar 
with the material covered in the Introduction to DATATRIEVE-11. For the 
more advanced topics in this manual (especially in Chapter 3), you should be 
familiar with the material in the DATATRIEVE-11 User’s Guide about record 
definitions, record selection expressions, variables, procedures, and command 
files. In addition, you may need to refer to the section on the EDIT_STRING 
clause in Chapter 5 of the DATATRIEVE-11 Reference Manual. 


Manual Structure 


This manual has three chapters: 


Chapter1 Introduces the Report Writer and provides examples of simple 
reports. 


Chapter2 Describes how to develop a report specification, the instructions 
that control the content and format of a report. The chapter pre- 
sents the Report Writer’s default and optional settings. 


Chapter3 Discusses advanced techniques of report writing with 
DATATRIEVE-11. It covers such topics as reporting groups of 
sorted records and reporting data from several domains. 


Appendix A Contains the data files used in the examples in this book. 
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Conventions 


The following list explains the special symbols used in this book: 


RET The symbol @&) tells you to press the RETURN key on the keyboard of 
your terminal. 

TAB The symbol (48 tells you to press the TAB key on the keyboard of your 
terminal. 


CTRUX The symbol tells you to press the CTRL (control) key and a letter 
key (usually Z or C) at the same time. 


color Text printed in red shows the lines you type while doing the examples. 


Related Documents 


You can find additional information in the following documents: 
e DATATRIEVE-11 User’s Guide 

e DATATRIEVE-11 Call Interface Manual 

e DATATRIEVE-11 Reference Manual 


Vill 
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DATATRIEVE-—11 allows you to organize and maintain data conveniently. A 
major reason for keeping this data is to make it available to the people who need 
it. DATATRIEVE’s Report Writer helps you present this information in attrac- 
tive and comprehensive reports. 


Managers, secretaries, and many other people often need information immedi- 
ately on a specific subject. To produce simple query reports, they need reliable 
techniques for presenting information. With a few simple statements and com- 
mands, you can quickly display and accurately summarize data managed by 
DATATRIEVE. 


In addition to query reports, most organizations require detailed summary 
reports at regular intervals to compare current performance with past perfor- 
mance. These periodic reports are on subjects such as accounts receivable, inven- 
tory, and sales. The statistical functions within the Report Writer allow anyone 
to summarize the information needed for periodic reports. 


Those who want the same report formats repeatedly can define DATATRIEVE 
procedures or use command files to save their report specifications. This manual 
teaches you by example how to generate many types of reports ranging from sim- 
ple queries to complex summary reports. 


The examples in this book use the sample domains YACHTS, PERSONNEL, and 
FAMILIES installed with your system. If the data in your files has changed since 
installation, your results may differ from those in the book. To check your data 
files with the ones these examples use, see Appendix A. 


If your data file is different from that in Appendix A, you can either modify your 
data or see your system manager to obtain the original file. 
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1.1. Whatthe Report Writer Can Do 


The Report Writer can: 
1. Center a report name at the top of the page 
2. Print the current date at the upper right 
3. Print page numbers at the upper right 
4. Set up column headings 
5D 


. Print a data line with information about individual records (a detail line) for 
each record 


6. Calculate and print a line of summary totals for: 
a. A group of data (such as yachts by the same builder) 
b. The entire report (such as yachts by several builders) 


Each number corresponds to a feature listed in the following report produced 
by the Report Writer: 


a4 


YACHTS BY ALBERG» 30-Arp r-83———2) 
ALBIN: AND AMERICAN Page 1 
LENGTH 
OVER 
MANUFACTURER MODEL RIG ALL WEIGHT BEAM PRICE—~{4) 
ALBERG ~ 37 MK II KETCH 37 204000 12 $36,951) 
BOAT COUNT: 1 AVERAGE PRICE: $36,951 


KEEKEKRKEKRHRHEKRKHHKEHHEERKRHEKEKRKKKHREKHHKEEKEHEREHE 


ALBIN 79 SLOOP 26 4,200 10 = $17+900 
ALBIN VEGA SLOOP 27 5070 08 $18,600 
ALBIN BALLAD SLOOP 30 7276 10 $27,500 

BOAT COUNT: 3 AVERAGE PRICE: $21 1333 ——€a) 

KEEKEKEKKEKKKEHEKEKKHEKEKEEKERKEKREKEKEERKREKRHKEKEKREHRKREKE 

AMERICAN 26 SLOOP 26 ~ 4,000 08 $9895 
AMERICAN 26-MS MS 26 5 1500 08 $18,895 

BOAT COUNT: 2 AVERAGE PRICE: $14,395 


KEEEEHEEEKEKKKEEKRHKEEKKEKRKKRKKEKKEHKKRERHREKREEE 


TOTAL BOAT COUNT: 6G OWERALL AVERAGE PRICE: $21 +140 ——€b) 
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1.2 Writing Reports 


With DATATRIEVE, you can produce reports both inside and outside of the 
Report Writer: 


e With the PRINT statement to display data from one group of records 
e With the SUM statement to generate summary totals from groups of records 


e With the Report Writer, providing the most flexibility for designing the format 
and content of reports and providing the option of printing the report directly 
on a line printer 


The following sections illustrate these three methods of report writing in 
DATATRIEVE. You can use the examples as models for creating similar reports 
with your own data. 


1.2.1 The PRINT Statement 


When you display records with the PRINT statement outside of the Report 
Writer, you create a simple report. To display the YACHTS built by ALBIN, 
type the following, being sure to use all uppercase letters for “ALBIN”: | 


DTR> READY YACHTS@E 


DTR? PRINT YACHTS WITH BUILDER = "ALBIN"@eD 

LENGTH 

OVER 
MANUFACTURER MODEL RIG ALL WEIGHT BEAM PRICE 
ALBIN 79 SLOOP 26 4;200 10 $17,900 
ALBIN BALLAD SLOOP 30 7+276 10 $27;500 
ALBIN WEGA SLOOP 27 5070 O08 =$18,600 
DT > 


1.2.2 The SUM Statement 


You may want to summarize information about selected groups within your 
report. The simplest way is with DATATRIEVE’s SUM statement outside of the 
Report Writer. For example, assume that you have a collection of seven records 
from the YACHTS domain. Use the SUM statement to indicate the number of 
yachts and the total price for each builder. 


The SUM statement in the following example means “Summarize the first seven 
yachts, telling the total number and total price of yachts for each builder and the 
total number and total price of all yachts in the collection.” 


The command SET NO PROMPT, which is included in many of the following 
examples, stops DATATRIEVE’s prompting for elements needed to complete 
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your current command or statement. If you omit SET NO PROMPT, prompts 
such as “Looking for next element in list” appear on your terminal. SET NO 
PROMPT does not affect your report in any way. 


DTR?> SET NO PROMPT@E) 

DTR> READY YACHTS: FIND FIRST 7 YACHTS@eD 
C7 records found] | 

DTR= SUM it ("NUMBER") USING 9 »@eD 

CON? PRICE USING $$4$$,%%% BY BUILDER@&E 


MANUFACTURER NUMBER PRICE NUMBER PRICE 


ALBERG 1 $36 +951 
ALBIN 3 $64 2,000 
AMERICAN 2 $28 +790 
BAYFIELD 1 $32,875 
7 $162,616 
DTR = 


The report separates the seven records into four groups of builders. It summa- 
rizes data not only for each builder, but for all builders. 


The SUM statement is the simplest way to create summary reports. See Chapter 
3 for information on advanced summary reports. 


1.2.3 The Report Writer 


The PRINT and SUM statements give you some control over the display of your 
data, but the Report Writer helps you format the page more than the PRINT 
statement does. You can produce the simplest reports with only a few statements: 


e A REPORT statement to invoke the Report Writer and to identify the data that 
you wish to report. 


e One or more SET statements to name the report and control the format. (SET 
statements are optional. If you prefer, the Report Writer can do all the format- 
ting for you.) 


e A PRINT statement to indicate which fields from the records you want to 
display. 


— Note that the Report Writer PRINT statement is different from the regular 
PRINT statement in DATATRIEVE. In the Report Writer, you list the fields 
or value expressions that you want to display. You cannot say “PRINT 
CURRENT” or “PRINT YACHTS”, because “CURRENT” and “YACHTS” 
are not field names or value expressions. 


e An END_REPORT statement to tell DATATRIEVE to create and display the 
report. 
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To find out the names of fields you can specify in the PRINT statement, use a 
SHOW FIELDS command to display the field structure of the record: 


DTR: SHOW FIELDS@éE 
YACHTS 
BOAT 
TYPE CIndexed field] 
MANUFACTURER (BUILDER) [Character strings indexed Key] 
MODEL [Character string+ indexed Key] 
SPECIFICATIONS (SPECS) 
RIG [Character string] 
LENGTH_-OVER_ALL (LOA) [Character string] 
DISPLACEMENT (DISP?) CNumberd 
BEAM [Number 
PRICE CNumbe rd 
DTR > 


BOAT is the top-level field for the records in the YACHTS domain. BOAT 
includes all of the fields in YACHTS. If you want to report all the data on each’* 
yacht, specify BOAT in the PRINT statement. 


Example: Report on all the yachts manufactured by Albin. Name the report 
“YACHTS BY ALBIN”, and include a date and page number. 


To produce the report, follow these steps: 


1. Report each record in YACHTS for the builder ALBIN. The REPORT state- 
ment identifies the data and invokes the Report Writer. The RW> prompt 
shows that DATATRIEVE is ready to accept your Report Writer statements. 


2. Name the report. 


3. Print the top-level field BOAT for each record. By doing so, you display all 
the data on each yacht. 


4. End with an END_REPORT statement. 


The following DATATRIEVE session illustrates these steps. The number after 
each statement corresponds to one in the list above: 


DTR> REPORT YACHTS WITH BUILDER = "ALBIN" @)}—-—HWW—_() 
RW> SET REPORT_NAME = "YACHTS BY ALBIN"@e) —HWHWHW————_———(2) 


RW? PRINT BOATRED 


RW> END _REPORT@EQ) —£ @ ———O@ ————__________—____-—_____________44) 
YACHTS BY ALBIN 20-Aug-83 
Page 1 
LENGTH 
OVER 
MANUFACTURER MODEL RIG ALL WEIGHT BEAM PRICE 
ALBIN 79 SLOOP 26 41200 10 $17 1900 
ALBIN BALLAD SLOOP 30 71276 10 $27 +500 
ALBIN VEGA SLOOP 27 51070 o8 $18 +600 
DTR> 
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Note the way the Report Writer sets up the page format. The page has the date 
and page number in the upper right corner. In this example, the Report Writer 
automatically sets the page width at 80 columns per page, spacing the fields of 
each record for you. 


1.3 Saving Report Statements 
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When you need to produce the same report periodically, you can save the Report 
Writer specification by putting the statements ina DATATRIEVE procedure or a 
command file. 


1.3.1 Using Procedures 


You define a procedure by: 
1. Typing DEFINE PROCEDURE procedure-name at the DTR> prompt 


2. Typing the report statements exactly as you would enter them outside a 
procedure 


3. Typing END_ PROCEDURE 


By using one or more prompting value expressions within your procedure, you 
can let other people tailor the report. The prompting value expression consists of 
an asterisk (*) and a period, followed by an expression enclosed in quotation 
marks. 


For example, you can include this statement: 


REPORT YACHTS WITH BUILDER = *."the builder" 


When you invoke the procedure, the terminal displays the following prompt: 


Enter the builders: 


DATATRIEVE does not process the report until you enter the name of the 
builder. 


Example: Define a procedure YACHT_PER_LB to produce a report with col- 
umns for these fields: 


e MANUFACTURER 
e MODEL 

e DISP CWEIGHT”) 
e PRICE 


In addition, create a new column showing the price per pound of each yacht. The 
Report Writer calculates the price per pound by dividing the number in the 
PRICE field by the number in the DISP field. 
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Follow these steps: 


1. 
2. 
3. 


5. 

6. 

ve 
The 


Define a procedure YACHT_PER_LB. 
Ready the domain YACHTS. 


Identify the data you wish to report within the REPORT statement. Include 
a prompt so the user can select the builder’s name. 


. Specify the items in each detail line with a PRINT statement. These items 


become the columns for the report. Create a column for price per pound by 
including PRICE/DISP as one of the items. The “/” indicates division. Use the 
edit string clause $$.99 to print the price per pound as a monetary value. 
(Chapter 2 discusses computed value expressions and edit strings in more 
detail.) 


End the report specification with an END_REPORT statement. 

End the procedure with an END_PROCEDURE statement. 

Invoke the procedure by typing :YACHT_PER_LB. 

following DATATRIEVE statements produce the report. The number after 


each statement corresponds to one in the preceding list: 


DTR > 
DFN > 
DEN = 
DF N = 
DFN = 
DFN > 
DFN = 
DFN > 
DTR = 


DEFINE PROCEDURE YACHT_PER_LB@Q ———HH (11) 


READY YACHTS@® 
REPORT YACHTS WITH BUILDER = *."the builder"@) ———————_) 
SET REPORT_NAME = "YACHT PRICES BY WEIGHT"@@ 

PRINT TYPE; DISP; PRICE »@e 

PRICE/DISP ("PRICE/LB") USING $%,99@e 

END_REPORT@E 

END_PROCEDURE@) — —___________—____—— @) 
: YACHT_PER_LB@D 


Enter the bKnilder: AMERICAN®E 


YACHT PRICES BY WEIGHT 17-Apr-83 


Page 1 
MANUFACTURER MODEL WEIGHT PRICE PRICE/LB 
AMERICAN 26 4,000 $9,895 $2,47 
AMERICAN 2£6-MS 57500 $18,895 $3.43 


DTR> 


1.3.2 Using Command Files 


You 


can also place report specifications in command files outside DATATRIEVE 


using a text editor. 
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For example, invoke a text editor, name the command file YACTWT.CMD, and 
enter the statements to create your report, just as you would enter them within 
DATATRIEVE: 


READY YACHT S@ED 

REPORT YACHTS WITH BUILDER = *,."the builder" (eD 
SET REPORT_NAME = "YACHT PRICES BY WEIGHT "@Eé 
PRINT TYPE+ DISP+ PRICE +eD 

PRICE/DISP ("PRICE/LB") USING $%,.99@eD 

END REPORTED 


Exit from the text editor. Invoke DATATRIEVE and execute the command file, 
by typing the @ symbol and the command file name. The following statements 
produce the report: 


DTR* @YACTWT.CMD@ED 

READY YACHTS 

REPORT YACHTS WITH BUILDER = *."the builder" 
SET REPORTUNAME = "YACHT PRICES BY WEIGHT" 
PRINT TYPE, DISP+ PRICE, 

PRICE/DISP ("PRICE/LB") USING $¢,99 
ENDUREPORT 

Eroter the builder: AMERICAN®@ED 


YACHT PRICES BY WEIGHT 17-Apr-83 
Page i 
MANUFACTURER MODEL WEIGHT PRICE PRICE/LB 
AMERICAN 26 4,000 $9,895 $27,447 
AMERICAN “6-MS 5500 $18,895 $3.43 


DTR> 


For each report you can decide whether to create the report specification interac- 
tively, to put it into a procedure, or to put it into a command file. In any case, the 
sequence of report statements and their syntax remain the same. For more infor- 
mation on procedures and command files, see the DATATRIEVE-11 User's 
Guide. 


1.4 Printing Summary Statistics 
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If you want summary information on the data records in the report, use the 
Report Writer’s statistical functions to compute values for a summary line. The 
functions are: 


e COUNT 
AVERAGE 
TOTAL 


MAX (maximum value) 


MIN (minimum value) 
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Example: Report on yachts built by Albin. At the bottom of the report, indicate 
the total number of yachts and the average price of a yacht. Limit the page width 
to 70 columns. Follow these steps: 


1. Identify the data you wish to report within the REPORT statement. 


. Name the report. 


2 
3. Set the page width. 

4. Print the top-level field BOAT in each detail line. 
5 


. Summarize the report with an AT BOTTOM OF REPORT statement. Use 
COUNT for the total number of boats. To suppress the header “COUNT”, 
include a hyphen in parentheses after COUNT. Then apply AVERAGE to 
the field PRICE for the average price. 


6. End with an END_REPORT statement. 


The following group of statements produces the desired summary report: 


DTR? SET NO PROMPT@E) 
DTR: REPORT YACHTS WITH BUILDER = "ALBIN"@E 
-RW> SET REPORT_NAME = "YACHTS BY ALB IN"@) ——____-_—_-____—_—_—____(2 
RWS SET COLUMNS PAGE = 70¢). ——$£@ @ @—______$_$__——| __—__________{3 
RW: PRINT BOATR@E 
RW> AT BOTTOM OF REPORT PRINT SKIP» COL 10 +@eén 
FR ll > "BOAT COUNT:"» SPACE; COUNT (-) USING 29 >@en 
Ri > COL 45, "AVERAGE PRICE:"», AVERAGE PRICE Ge) —________—_{5) 
RW > END—RE POR T@ep) P22 JA ________—6) 
YACHTS BY ALBIN 10-Jan-83 
Page l 
LENGTH 
OVER 
MANUFACTURER MODEL © RIG ALL WEIGHT BEAM PRICE 
ALBIN 79 SLOOP 26 4.200 10 $17,900 
ALBIN BALLAD SLOOP 30 79276 10 $277 +500 
ALBIN WEGA SLOOP 27 5 +070 Og $18,600 
BOAT COUNT: 3 AVERAGE PRICE: $71,333 
DTR> 


Note that the Report Writer has lined up the value for the average price in the 
PRICE column. 


These sample reports demonstrate only a few applications of DATATRIEVE’s 
Report Writer. The next two chapters discuss and illustrate other features to con- 
trol the format and content of reports. 
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Designing a Report 


You may be content to allow the Report Writer to supply the date, page number, 
page width, and other characteristics for your report. If you are, you need only 
concern yourself with what you want to put into the report, not how to design the 
report itself. 


At times, though, you may want to supply your own formats. You are likely, for 
instance, to want to supply a name for your report. Unless you specify a name, 
the Report Writer generates a report without one. 


Once you begin to specify titles, you may want to change page widths or provide 
your own column headers. This chapter tells what the Report Writer does for you 
and how to do those things for yourself if you wish. 


You create a DATATRIEVE report with a series of Report Writer statements, 
called a report specification. A report specification controls the format and deter- 
mines the content of a report. Some statements are required for a valid report 
specification, while others are optional. 


These are required statements: 

e A REPORT statement 

@ One PRINT statement or at least one AT statement 
° An END_REPORT statement 

These are optional statements: 


e Statements to specify particular data you want for the report from all the 
available data 


e Statements to specify the file or device to which DATATRIEVE writes the 
report 
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e ASET REPORT_NAME statement 
e SET statements to control page format and assign headings 
e AT statements if you wish to summarize data or print special headings 


Each major section of this chapter discusses a part of the report specification. 
Each section discusses first the format built into the Report Writer (the default 
format) and then your options to change the default format. 


You can incorporate one or more of the options into your report specification. If 
you are satisfied with the default format, skip the option section that immedi- 
ately follows. 


For example, the Report Writer automatically sets your page width at 80 col- 
umns per page. If you want to use that page width, you need not change it. But 
you can include an optional statement (SET COLUMNS_PAGE) to specify a dif- 
ferent page width. 


To start a report design, take a piece of paper to make a rough sketch of a report 
that you would like to produce. Indicate the information you would like the 
report to contain, and the basic format for each page. Then read each section of 
this chapter to develop a report specification that produces such a report, using 
the instructions and examples provided as aids. 


Identifying the Data and Invoking the Report Writer 


Reports usually highlight only a portion of the available information. To report 
specific data, you must identify it to DATATRIEVE and invoke the Report 
Writer. Follow these steps: 


1. Ready the domain(s) containing the data you wish to report: 


DTR> READY YACHTS@E 
DTR > 

2. Identify the data that you want to report within the domain, so you can limit 
the number of records in the report and sort the records if you desire. You can 
identify the data in one of two ways: in a FIND statement that precedes the 
report statement or with the REPORT statement itself. 


This example shows a FIND statement that forms a sorted collection from 
the YACHTS domain: 


DTR> FIND YACHTS WITH LOA =} 40 SORTED BY BEAM@E) 
[8 records foundd 
DTR > 


3. Enter the REPORT statement to invoke the Report Writer. The format of the 
REPORT statement is: 


file-spec 
REPORT [rse] [ON eb i 
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The following are valid REPORT statements: 


} e REPORT — When you omit the RSE (record selection expression) from the 
REPORT statement, the Report Writer reports on the records in the 
CURRENT collection: 


DTR> REPORT@®) 
RW> 


@ REPORT ON file-spec— When you specify the output file and no RSE, the 
Report Writer reports on the CURRENT collection and writes the report to 
a file. For example, this statement writes the report to the file 
BIGYAT.LST: 


DTR> REPORT ON BIGYATE@E 
RW > 


If your REPORT statement includes an ON clause, the Report Writer 
_. advances the page after printing the report. That is, it places a trailing 
form feed on the report. If you do not include an ON clause, it does not add 
a form feed to the end of the report. 


e REPORT rse - If you did not form a collection with a FIND statement, you 
must identify a record stream with the REPORT statement. For example: 


DTR? REPORT YACHTS WITH DISP + 25000@E) 
FR bal > 


) 2.2 Correcting Mistakes in the Report Writer 


You can correct mistakes in a Report Writer specification by retyping the 
specification or by editing the procedure or command file that contains the report 
statements. 


2.2.1_ Returning to the DTR> Prompt 


You invoke the Report Writer with a REPORT statement, and you exit with 
END_REPORT. However, if you make a mistake, you may want to exit before 
completing your report specification. 


To force an exit from the Report Writer and return to DATATRIEVE command 
level, you can enter CTRL/Z as a response to an RW> prompt or in the middle of 
an input line: 


DTR> READY YACHTS@E 
DTR? REPORT YACHTS@E) 
RW > 

DTR > 


When you see the DTR> prompt, you can retype your Report Writer 
' specification. : 
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2.2.2 Usinga Text Editor to Correct Mistakes 


If you enter your report specification statements ina DATATRIEVE procedure or 
in acommand file outside DATATRIEVE, you can correct errors easily and 
quickly. 


To correct Report Writer statements contained ina DATATRIEVE procedure, 
follow these steps: 


1. Use the EXTRACT command to copy the procedure to a file, using the 
statement: 


EXTRACT ON file-spec procedure-name 
. EXIT from DATATRIEVE. 
. Use a text editor to make corrections in the procedure. 


. Return to DATATRIEVE. 


oO -& GW bv 


. Invoke the command file just created. 


Notice the file begins with the commands DELETE procedure-name and 
DEFINE procedure-name. DATATRIEVE inserts these commands into the 
command file when you use the EXTRACT command. When you invoke the 
file, DATATRIEVE deletes the incorrect procedure and creates the corrected 
one. 


6. Execute the procedure. 


You also use the text editor to correct Report Writer statements in a command 
file created outside DATATRIEVE. When you execute a file containing errors in 
the report specification, DATATRIEVE sends you a message and returns you to 
the DTR> prompt. To correct the errors, exit from DATATRIEVE and edit the 
command file. Invoke DATATRIEVE again and execute the corrected command 
file by typing the @ symbol and the command file name. 


2.2.3 Using the DATATRIEVE Editor to Correct Mistakes 


You can use the DATATRIEVE Editor to correct report statements contained in 


a procedure. Type the command: 


EDIT Procedure-name 


For a detailed explanation of the DATATRIEVE Editor, procedures and 
command files, see the DATATRIEVE-11 User’s Guide. 


2.3 Formatting the Report Page 


2-4 


One of the main advantages of the Report Writer is its ease of formatting. You 
can use the Report Writer’s default format, or you can include SET statements to 
specify the number of columns and lines per page, and the maximum number of 
lines or pages in a report. 
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2.3.1 Default Page Width and Length 


The default format is the setting the Report Writer uses unless you specify other- 
wise. For page width and length, these are the defaults: 


e Page width = 80 columns 
e Page length = 60 lines | 


2.3.2 Option 1: Setting the Page Width 


If you do not want to use the default format of 80 columns per page, youcan 
specify the number of columns by putting a SET COLUMNS_PAGE statement 
in your report specification. The statement has this form: 


n 
SET COLUMNS_PAGE = * prompt 


The value n is the number of columns per page. The maximum value for n is 255. 


You can use this command at DTR command level or in the Report Writer to set 
the page width for reports. If you use the command in the Report Writer, it does 
not affect the page width when you return to the DTR> prompt. 


If you make the width too small, the Report Writer breaks each detail line and 
moves the fields that do not fit to the next line of the display. In considering the 
setting for page width, take into account the number of columns used to display 
the same fields outside the Report Writer with the regular PRINT statement. If 
you request totals and other special value expressions on the detail line, you 
must add in the additional columns required for these print objects. 


To set the page width at 60 columns, enter: 


RWe SET COLUMNS_PAGE = GO@E) 


If you use the prompt option, you can choose the page width when you process the 
report. 


2.3.3 Option 2: Setting the Page Length 
If you do not want to use the default format of 60 lines per page, you can include a 
SET LINES. PAGE statement within your report specification. The statement 
has the following form, where n is an integer representing the number of lines 
per page: 

n 
SET LINES_ PAGE = } * prompt ( 


To set the page length at 55 lines, enter: 


RA SET LINES_PAGE = SS@H 
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If you use the prompt option, you can choose the page length at the time you pro- 
cess the report. | 


If your report contains a list, each item in the list counts as a separate detail line. 


If you want a report without any page breaks, give n a value larger than the 
number of lines in the report. 


To be sure that you have set up your page the way you would like it, you may 
have to experiment with two or three versions of the lines-per-page value. 


2.3.4 Option 3: Limiting the Total Lines or Pages in a Report 


The Report Writer limits the number of lines in a report to 32,767. It limits the 
number of pages to 32,767 also. Because the automatic limit is so large, you may 
want to use the SET MAX_LINES or SET MAX_PAGES statement to prevent a 
loop that would tie up your system’s resources. These statements specify the 
maximum number of lines or pages your report can contain. For the statement 
SET MAX_LINES, DATATRIEVE counts header lines, blank lines, detail lines, 
and summary lines. The two formats are similar: 


n 

SET MAX_LINES = "prompt 
n 

SET MAX_PAGES = +" promt | 


The Report Writer counts all the lines or pages of the report. When it reaches the 
limit you have specified, it stops producing the report and prints one of the follow- 
ing error messages: 


Maximum number of lines exceeded--report aborted 
Execution failed 


Maximum number of Pages exceeded--report aborted 
Execution failed 


If you use the prompt option, you can select the maximum number of pages or 
lines at the time you process the report. For example: 


DTR? READY YACHTS@E 

DTR?> REPORT YACHTS@E 

RW PRINT BOAT@ED 

RW> SET MAX PAGES = *."the maximum number of pages "QED 

RW? END UREPORT@ED : 
Enter the maximum number of pages: 1&8 
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LENGTH 
OVER 
MANUFACTURER MODEL RIG ALL 
ALBERG 37 MK II KETCH 37 
ALBIN 79 SLOOP 26 
ALBIN BALLAD SLOOP 30 
ALBIN WEGA SLOOP 27 
AMERICAN 26 SLOOP 26 
GRAMPIAN 34 KETCH a3 
Maximum number of Pages exceeded--report aborted 


Execution failed 


DTR> 


2.4 Setting Up the Report Heading 


WE TGHT 


20,000 
45200 
79276 
29070 
4.000 


12,000 


BEAM 


12 
10 
10 
08 
08 


LO 


9-Mar-83 
Page 1 - 


PRICE 


$36,951 
$17,900 
$27 9300 
$198 +600 
$9,895 


$29 +675 


The report heading consists of the report name, date, and page number. You can 
let the Report Writer use the default format or you can specify a report heading 
with SET statements. 


2.4.1 


Default Format 


The default format for the report heading is: 


e Report Name — The Report Writer prints no title, unless you include a SET 


REPORT_NAME statement. 


e Date — The Report Writer prints the current system date in the upper right cor- 
ner of the page. It uses the format DD-Mmm-YY (for example, 21-Jan-83). 


e Page number — The Report Writer prints the page number of the report 
directly under the date. Regardless of the lengths of the date string and the 
page number, the Report Writer aligns the first character of the page number 
identification under the first character of the date. It uses the format Page n. 
For example: 


2.4.2 Option 1: Naming the Report 


21-Jan-83 


Page = 


Use the SET REPORT_NAME statement to name your report. Be sure to enclose 
the name in quotation marks. The Report Writer centers this name on the first 


printed line at the top of the page. For example: 


DTR> 
DTR> 
RW > 
RW > 
RW > 


SET NO PROMPT@ED 
REPORT YACHTS@® 

SET REPORT_NAME =@e 
"ACCOUNTS PAYABLE FOR 
END-REPORT@®) 


BOCK ’S YACHTS "@eD 
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This statement produces the following title: 


ACCOUNTS PAYABLE FOR BOCK’S YACHTS 21-Jan-83 
Page 1 


The SET REPORT_NAME statement has the following syntax: 


For naming the report: 


SET | REPORT_NAME = foe 
.prompt 


For specifying a date or string at the upper right of each page: 
SET DATE = “string” 


For controlling the printing of a date or page number: 


NO DATE 
NUMBER 
NO NUMBER 


SET arn 








For specifying page width or length, or overall report length: 


LINES_PAGE = n 
MAX_LINES = *,prompt [,...] 


COLUMNS_PAGE = 
SET | 
MAX_PAGES = 


You are not limited to report names of one line. To produce a report name of two 
or more lines, enclose each segment of the report name in quotation marks and 
separate each segment from the next with a slash (/): 


DTR> REPORT YACHTS@ 

RW> SET REPORT NAME =@e 

RW> “ACCOUNTS PAYABLE"/"FOR BOCK’S YACHTS"@® 
RW> END-REPORT@E 


This statement produces the following report heading: 


ACCOUNTS PAYABLE 18-Apr-83 
FOR BOCK ’S YACHTS Page 1 


You can also have the Report Writer prompt you for a name each time it pro- 
cesses a report. In response to the prompt, enclose each segment in quotation 
marks, and separate each segment from the next with a slash. For example: 


DTR> READY PERSONNEL@EéD 

DTR> REPORT FIRST 2 PERSONNEL@E) 

RW> SET REPORT_NAME = _#,."rerPport name"(EéE) 

RiW> PRINT PERSON@ED 

RW> ENDOREPORTQ@E 

Enter report name: "EMPLOYEE STATUS"/"FOR FIRST QUARTER"@ED 
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ID 


O Oo - 
O0891 


DTR? 


This statement produces the following report: 


EMPLOYEE STATUS 17-Jan-83 
FOR FIRST QUARTER Page lI 
FIRST LAST START SUP 
STATUS NAME NAME DEPT DATE SALARY ID 
XPERTENCED CHARLOTTE SPIVA TOP 12-Sep-72 $75,892 oo0o012 
XPERTENCED FRED HOWL Fil 99-Apr-76 $39,594 o00012 


If you include a one-line name for the report, the name prints on the same line as 
the page number. 


To produce a report with no name, do not use the SET REPORT_NAME state- 


ment at all. There is no default report name. 


2.4.3 Option 2: Assigning a Date 


With the SET DATE statement, you can replace the default date in the top right 
corner of the page with another date or any other character string: 


DTR> REPORT YACHTS@ED 


RWe> SET DATE = "22 MAR 1983 "@eD 
RW> END-REPORT@E) 


This statement produces: 


e2- MAR 1983 
Page l 


You can use a variety of date formats. For example: 
DTR> REPORT YACHTS@E 


RW> SET DATE = "TUESDAY: MARCH 14TH"@éD 
RW> END-REPORTQED 


This statement produces: 


TUESDAY + MARCH 14TH 
Page Il 


You can specify wording that has no connection at all with dates. For example: 
DTR> REPORT YACHTS@E 


RW? SET DATE = "COMPANY CONFIDENTIAL" @eD 
RW> END-REPORTQ@ED 


This statement produces: 


COMPANY CONFIDENTIAL 
Page Il 
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2.4.4 Option 3: Suppressing a Date 


If you do not want a date on your report, include the SET NO DATE statement as 
part of your report specification. 


DTR> REPORT FIRST 3 YACHTS@ED 

RW> SET NO DATERED 

RW> SET REPORT_NAME = "FIRST BOATS"@e) 
RW> PRINT BOAT@ED 

RW> END_REPORT@E 


FIRST BOATS Page l 

LENGTH 

OVER 
MANUFACTURER MODEL RIG ALL WETGHT BEAM PRICE 
ALBERG 37 MK II KETCH 37 2099000 id $36,951 
ALBIN 1 SLOOP 26 49200 10 $17 +900 
ALBIN BALLAD SLOOP 30 79276 10 $27 +900 


DTR > 
2.4.5 Option 4: Suppressing the Page Number 


If you do not want any page numbers on your report, include the SET NO 
NUMBER statement as part of your report specification. 


DTR> REPORT FIRST 1 YACHTS@E 
RW> SET NO NUMBER@«ED) 

RW? PRINT BOATQ@ED 

RW> END_REPORT@ED 


13-Sep-82 
LENGTH 
OVER 
MANUFACTURER MODEL RIG ALL WEIGHT BEAM PRICE 
ALBERG 3/7 MK II KETCH 37 20,000 es $36;951 


DTR> 


Unless you suppress the page number, the Report Writer automatically prints 
the page number in the upper right corner of the page. 


2.5 Printing Detail Lines and Column Headers 


Detail lines contain information about individual records from a domain. The 
Report Writer arranges the information in columns, and the column headers 
from the DATATRIEVE domain tell what the information in each column 
represents. 
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The Report Writer PRINT statement produces a detail line in the report for every 
record in the CURRENT collection or in the specified record stream. A detail line 
can cover several lines on the report page, depending on the content and format 
you specify. 


With the Report Writer PRINT statement, you can specify three characteristics 
of the detail lines: 


e The content of the detail lines: 


— Values of fields from records identified either by a FIND or by aREPORT 
statement 


— Value Expressions 
e The format of the print items in the detail lines: 
— Order of each print item 
— Column position of each print item 
— Edit string format for each print item 
© Column headings for each print item 


For further discussion of the Report Writer PRINT statement, see the 
DATATRIEVE-11 Reference Manual. 


2.5.1 Content of the Detail Line 


A detail line can have two kinds of print items. The first is the value of a field 
from the record. One example is the value of the PRICE field from YACHTS. The 
second is a value expression. You may derive value expressions from field values, 
as in PRICE/DISP (price per pound) or PRICE* 1.1 (10% markup on price). Value 
expressions may also be literals, variables, or prompt options. 


2.5.1.1. Field Values — You determine the content of the detail line by indicat- 
ing which fields from the record the Report Writer should print. You can specify 
either elementary fields or group fields. In the case of a group field, each of its ele- 
mentary fields appears in a separate column. 


Example: Print the TYPE and PRICE fields of the YACHTS domain in the 
default format. The report displays the group field TYPE as two columns, one 
for each elementary field (MANUFACTURER and MODEL) TYPE contains: 


DTR> REPORT FIRST 2 YACHTS@H 
RM> PRINT TYPE, PRICE@®D 

RW> SET COLUMNS_PAGE = GO@E 
RW> END REPORT@E) 
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27-Aug-83 


Page l 
MANUFACTURER MODEL PRICE 
ALBERCG 37 MK II $36,951 
ALBIN 79 $17,900 


DTR> 


2.5.1.2 Value Expressions — Youcan create additional detail line items 
computed from other field values with DATATRIEVE’s arithmetic or statistical 
operators. In addition, you can include other value expressions such as literals, 
variables, or prompting value expressions. 


Example: Display the model, current price, and a new price 10 percent higher 
than the current price for the first five records in the YACHTS domain. 


DTR> SET NO PROMPTED 

DTR: REPORT FIRST 3 YACHTSRE) 

RW> SET COLUMNS_PAGE = 60@E) 

RW> SET REPORT_-NAME = "BOCK’S YACHTS"/"PRICE LIST" @eD 
RW? PRINT TYPE+ PRICEs PRICE * 1.1 USING $44 +%$4$@E) 
Ri: END UREPORT@ED 


BOCK ’S YACHTS 88-Mar-83 

PRICE LEST Page 1 
MANUFACTURER MODEL PRICE 
ALBERG 37 MA II $36 +951 $40+646 
ALBIN Vs $17 +900 $19,690 
ALBIN BALLAD $27 +900 $30 +250 
ALBIN VEGA $18,600 $20,460 
AMERICAN 26 $9,895 $10,884 


DTR > 


The edit string clause, USING $$$,$$$, specifies the output format for the PRICE 
*1.1 field. You need to use one more dollar sign than the maximum number of 
digits for the value expression. See Section 2.5.2.3 for more information on edit 
strings. 


2.5.2 Format of Fields in the Detail Lines 


The Report Writer determines a default format for each print item based on edit 
string or picture clauses in the record definition or variable declaration. You can, 
at your option, control the format within the PRINT statement. 
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DTR = 
RW > 
Rl > 
Ri > 


DTR? 


DTR > 
DTR > 
Rb > 
Rb > 
Rid > 
Rid > 


2.5.2.1. Order of Print tems — The order of the field names in the PRINT 
statement determines the left to right printing order of the detail line items. 
The following example shows how you can control the order of field names for 


YACHTS: 
REPORT YACHTS WITH BUILDER = "GRAMPIAN"@ 
PRINT MODEL» PRICE» MANUFACTURER»+ LOAG@E 
SET REPORT_NAME = "REPORT SHOWING PRINT ORDER"@€D 


END_REPORT@ED 


REPORT SHOWING PRINT ORDER 13-Sep-82 
Page i 
LENGTH 
OVER 
MODEL PRICE | MANUFACTURER ALL 
2- 3d $29,673 GRAMPIAN 34 
26 $11;495 GRAMPIAN <6 
28 $14,475 GRAMPIAN 28 
30 $17;+773 GRAMPIAN 30 
34 $29,675 GRAMPIAN 30 


2.5.2.2 Column Position of Print tems — The Report Writer automatically 
sets up the column spacing based on field, header, and page widths. If you want to 
change the default spacing, you can specify the print position of any or all of the 
print items. 


If you do not leave enough room for the column headers and data items, the 
Report Writer in some cases “wraps” the detail line. That is, it prints some items 
on a second line, including column headers. However, if a column header from 
the first line is so long that it wraps into the next header’s space in the second 
line, the Report Writer suppresses the next header altogether. If you let the 
Report Writer wrap the headers, make certain that all your headers appear in 
the final copy. 


If you choose to specify print positions, you can: | 
e Specify the column number where the Report Writer begins to print each item 


e Require spacing between columns by including a SPACE [n] element in the 
PRINT statement 


Here is an example of the first option: 


Example: Display the same fields from YACHTS, but begin each field at 20 
space intervals: 


SET NQ PROMPTED 

REPORT FIRST 2 YACHT S@ED 

SET REPORT.NAME = "REPORT SHOWING PRINT POSITIONS "@éeD 
PRINT COL 1+ MODEL, COL 21+ PRICE +@eD 

COL 4i, BUILDER, COL G1,» LOARED 

END_REPOR TED 
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REPORT SHOWING PRINT POSITIONS 17-Jan-83 
Page 1 


LENGTH 
OVER 
MODEL PRICE MANUFACTURER ALL 
37 MK II $36,951 ALBERG 37 
79 $17,900 7 ALBIN | 26 
 DTR? 
Here is an example of spacing with the SPACE [n] element: 
Example: Display the same fields, allowing five spaces between columns: 
DTR> SET NO PROMPT@E) 
DTR> REPORT FIRST 2 YACHTS@ED 
RW? SET REPORT_NAME = "REPORT USING THE SPACE ELEMENT" @&) 
RM> PRINT MODEL, SPACE 5+ PRICE, SPACE 5 + @é 
RW? BUILDER» SPACE 5+ LOAGE 
RW? END UREPORT@E 
REPORT USING THE SPACE ELEMENT 4-Oct-83 
Page 1 
LENGTH 
OVER 
MODEL PRICE MANUFACTURER ALL 
37 MK II $36,951 ALBERG 37 
79 $17,900 ALBIN 26 
DTR> 
2.5.2.3 Edit String Format of Print ltems — Ifyou declare an edit string fora 
field in the record definition, the Report Writer uses that edit string to format the 
print item. If you are setting up print items derived from field values, the Report 
Writer supplies an edit string. You can replace either edit string for a print item 
by specifying an edit string in the PRINT statement. 
The full range of edit strings for record definitions is available to you in Report 
Writer PRINT statements. With a USING clause, you can require that the 
Report Writer display the value of an alphabetic, numeric, or date field. The 
USING clause can contain commas, hyphens, percent signs, dollar signs, or deci- 
mal points. 
Example: You want a numeric field to represent money. All values for the field 
are'less than $10,000. You could choose the following edit string: 
RW> PRINT PRICE/DISP USING $$+$%%,99@9 
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Some values formatted with this edit string are: 
e $9,016.97 

e $995.38 

e $.99 


If a field contains a large amount of text, specify a T edit string. The format of a T 
edit string is T(n), where n is the column width. The T edit string instructs the 
Report Writer to print the text over several lines, with a maximum of n charac- 
ters per line. | 


The Report Writer does not divide any words across lines. 


If you put the T format value expression at the end of a line, the other print items 
all appear on the same line as the first line of text. 


For full information on the edit strings available within DATATRIEVE, consult 
the DATATRIEVE-11 Reference Manual. 


2.5.3 Column Headers for Print Items 


DATATRIEVE displays column headers at the top of the report and at the top of 
each page. The Report Writer uses the field name or the query header from the 
record definition as the default. 


2.5.3.1 Option 1: Suppressing a Column Header — If you do not want a col- 
umn header for an individual field, follow the print list item with a hyphen in 
parentheses: (-). For example: 


DTR? REPORT FIRST 1 YACHTS@E 

RW> SET COLUMNS_PAGE = 60@éE 

RW> PRINT MANUFACTURER» MODEL (-)+ LOA+ RIG: PRICE (-)@@ 
RW> END REPORT@ED 


95-Apr-83 
Page i 
LENGTH 
OVER 
MANUFACTURER ALL RIG 
ALBERG 37 MK II 37 KETCH $36 ;951 


DTR? 
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2.5.3.2 Option 2: Specifying a Column Header — Youcan choose the column 
header by following a print list item with the column header enclosed in paren- 
theses and quotation marks. For example, you could change the name of the first 
column header in the last example from “MANUFACTURER” to “VENDOR” by 
using this PRINT statement: 


DTR* REPORT FIRST 1 YACHTS@ED : 
RW? PRINT MANUFACTURER ("YENDOR") +» MODEL (-)+ LOA+s RIG+ PRICE (-) QED 
RW> ENDOREPORTQED 


The report specification with this revised print statement produces the following 
report: | 


o-MAY-8B3 
Page l 
LENGTH 
OVER 
VENDOR ALL RIG 
ALBERG 37 MK II 37 KETCH €36,951 


DTR? 


To include a column header of two or more lines, use the slash (/) between quoted 
strings. For example: 


DTR?= REPORT FIRST 1 YACHT S@eD 


RW? PRINT MANUFACTURER ("BOAT"/"BUILDER") + MODEL (-) + LOARED 
RW> END_REPORTQED 


The report specification with this revised print statement produces: 


17-Jan-83 
Page l 
LENGTH 
BOAT OVER 
BUILDER ALL 
ALBERG 37 MK II a7 


DTR =? 


For fields with one or two character values, you can compress the headers. The 
following PRINT statement specifies a three-line header for the LOA field: 


RW> PRINT MANUFACTURER: LOA ("L"/"O"/"A")s RIGs PRICERE) 
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Here is a sample report using this print statement: 


DTR> REPORT FIRST YACHT S@En 
RW? SET COLUMNS_PAGE = GO@E) 
RW? PRINT MANUFACTURER, LOA ("L"/"O"/"A") +s RIGs PRICERED 


RW> END_REPORTQ@ED 


17-Jan-83 
Page Il 
L 
0 
MANUFACTURER A RIG PRICE 
ALBERG 37 KETCH $36;951 


DTR > 
2.6 Summarizing Data 


You can instruct the Report Writer to calculate summary statistics for the report. 
Use the AT BOTTOM OF PAGE or the AT BOTTOM OF REPORT statements. 
(An AT BOTTOM OF field-name statement can generate summaries on groups 
within the report. See the next chapter for a discussion of dividing data records 
into groups.) 


As a general rule, it is best not to use the AT TOP OF REPORT or AT TOP OF 
PAGE statements for summarizing data. Use these statements for printing spe- 
cial headings in the report. 


2.6.1 COUNT, AVERAGE, and TOTAL 


With the statistical operators COUNT, AVERAGE, and TOTAL you can display 
the number of records in the report, the average value of the value expressions in 
the record stream, and the total value of those expressions. You use these statis- 
tical operators within PRINT or AT TOP or AT BOTTOM statements. 


Example: Bock’s Yachts has a PERSONNEL domain that stores data about the 
members of its sales force. Report the ID, last name, department, and salary for 
each salesperson. At the bottom of the report, show the number of salespersons 
(COUNT), the total salary (TOTAL SALARY), and the average salary 
(AVERAGE SALARY). 


Use a command file (.CMD) to create the report. The file AV.CMD and the report 
it generates follow: 


DTR? @AY.CMD 

READY PERSONNEL 

REPORT PERSONNEL 

SET COLUMNS_PAGE = G0 

SET REPORT_NAME = "BOCK’S YACHTS"/"SALARY REPORT" 
PRINT ID+ LAST_NAME», DEPT:+ SALARY 

AT BOTTOM OF REPORT PRINT SKIP 2,3 


COL 10, "WORK FORCE:"+ SPACE, COUNT (-) USING 29, 
COL 37,5 "TOTAL: "+ TOTAL SALARY USING $$%4 5$$%,99, 
COL 37, "AVERAGE:"+ AVERAGE SALARY USING $$% +$4$%,99 


END_REPORT 
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BOCK’S YACHTS 28-Feb-8983 
SALARY REPORT Page 1 
LAST 
ID NAME DEPT SALARY 
Ooo012 SPIVA TOP $75,892 
ooBo1 HOWL Fil $59,594 
02943 TERRY p98 $79,908 
12643 TASHKENT ce? $32,918 
32432 SCHWEIK Fil $76+723 
34456 MORRISON T32 $30,000 
38462 SWAY T32 $54,000 
38465 FREIBURG E46 $273,908 
39485 TERRICK D998 $55,829 
48475 CASSIDY EG $55,407 
48573 KELLER T32 $31,546 
49001 ROBERTS C8? $41;395 
49843 HAMMER Dg8 $76+392 
78923 HARRISON Fil $40+747 
83764 MEADER T32 $41,029 
84375 NALEVO bags $56 +847 
87289 DEPALMA G20 $57,598 
87465 IACOBONE ce2 $58,462 
87701 CHONTZ Fil $74,502 
ss8001 LITELLA G20 $34,933 
90342 DONCHIKOW Ce2 $35,952 
91023 WITTGEN G20 $75,023 
99029 PODERESIAN cee? $33,738 
WORK FORCE: 23 TOTAL: $952+343,00 


AVERAGE: $41,d06,.21 
2.6.2 Maximum Value and Minimum Value 


To show the maximum and minimum values of specific fields, use the operators 
MAX and MIN on the field names. These operators cause the Report Writer to 
display the maximum or minimum value of all value expressions in the record 
stream or current collection. 


- Example: Expand the salary report to indicate the maximum salary and the 
minimum salary. 


Use a command file (.CMD) to contain the statements to create the report. 
Here is the file SALSTA.CMD, followed by the report that it generates: 


DTR> @SALSTA GE) 

READY PERSONNEL 

REPORT PERSONNEL 

SET REPORT_NAME = “BOCK ’S YACHTS"/"DETAILED SALES REPORT" 

SET COLUMNS PAGE = 60 

PRINT ID+ LAST_NAME» DEPT+s SALARY 

AT BOTTOM OF REPORT PRINT SKIP 2, 
COL 10% "WORK FORCE:"+ SPACE» COUNT (-) USING 29» 
COL 37+ "TOTAL:"+ TOTAL SALARY USING $$ +5 199% 5$¢$¢,99,% 
COL 37+» "AVERAGE:"+ AVERAGE SALARY USING $$$ +5$¢$¢,99, 
COL 37+ "MAXIMUM: "+ MAX SALARY USING $$$ +%$$¢$,99, 
COL 37+ "MINIMUM: "+ MIN SALARY USING $$$ +5$$¢$,99 

END_UREPORT 


2-18 Designing a Report 


BOCK ’S YACHTS 8-Mar-83 
DETAILED SALES REPORT Page | 
LAST 
ID NAME DEPT SALARY 

QQ0 12 SPIVA TOP $73 :892 
gg0891 HOWL Fil $99,994 
02943 TERRY DOS $29,908 
12643 TASHKENT C82 $32,918 
32432 SCHWETK LL $265723 
34456 MORRISON Trae $30,000 
38462 SWAY T32 $94,000 
38465 FREIBURG E46 $23;908 
39485 TERRICK D98 $95 +829 
48475 CASSIDY EdG $99 9407 
48373 KELLER haz $31,546 
49001 ROBERTS C82 $41 +395 
49843 HAMMER D8 $26 +392 
7sg4a23 HARRISON Fit $40+747 
83764 MEADER 132 $41 +029 
84373 NALEVO D8 $96,847 
87289 DEPALMA G20 $97 +998 
87465 ITACOBONE C82 $98 +462 
S771 CHONT2 Pid $24 5502 
B8o01 LITELLA G20 $34,933 
90342 DONCHIKOY C82 $33,952 
91023 WITTGEN G20 $29 7023 
I9o29 PODERESTIAN C82 $33 +738 
WORK FORCE: 23 TOTAL: $992 19343.00 


AVERAGE: $41,406.21 
MAXIMUM: %$75+892,00 
MINIMUM: $23,908.00 


One other way to produce the report is to define a procedure within 
DATATRIEVE. Invoke the procedure at DATATRIEVE command level (indi- 
cated by the DTR> prompt) by typing a colon and the procedure name. 


The last two examples use AT BOTTOM statements to produce overall page and 
report summaries. You can also use AT BOTTOM statements to divide your data 
records into groups. You can then compile statistics about groups of records, as 
well as about all the records. 


2./ Selecting the Output Device or File 
With the REPORT statement you can select the device or file that is to receive 


the report. If you use the prompt option, you can choose the output device imme- 
diately before you produce the report. | 
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DTR > 
DTR + 
RW > 
RW > 
RW > 


2./.1_ Default: Output to Terminal 


If you begin your report specification with a statement of the form “REPORT 
[rse]”, the Report Writer displays the report on your terminal. Such a statement 
is equivalent to an explicit declaration of the form “REPORT [rse] ON TI:” except 
that the Report Writer does not start a new page after the report as it does when 
you use the ON clause. 


2.7.2 Option 1: Output to a Line Printer 


To get a copy of your report from a line printer, type the device name of the line 
printer at the end of the REPORT statement: 


DTR> REPORT ON LP:@eD 


If the REPORT command contains an RSE, put the output specification after the 
RSE: 


DTR* REPORT YACHTS WITH BUILDER = PEARSON ON LP: @eD 


2.7.3 Option 2: Output to a File 


If you want to store your report in a file, end the REPORT statement with ON fol- 
lowed by a file specification. This example creates a file called REPORT.TXT in 
your default directory: 


DTR* REPORT BIG_LONES ON REPORT. TXT@ED 


If you send your report to a file, you can use your operating system’s commands to 
print a hard copy at your convenience. 


For RSTS/E systems, if you specify an output file that already exists, the system 
sends you an error message and does not create the file. 


2.7.4 Option 3: Prompt 


If you want to choose the output medium at the time you process the report, use 
the prompt option. Then DATATRIEVE prompts you for the output medium 
when it processes the report: 


READY PERSONNEL @ 

REPORT FIRST 4 PERSONNEL ON ¥*."QUTPUT DEVICE OR FILE"@@ 
SET REPORT_NAME = *."THE NAME FOR THE REPORT "@eD 

PRINT ID+ NAME; SALARY@E 

END_REPORT@® 


Enter THE NAME FOR THE REPORT: "TOP ACHIEVERS" @eD 
Enter OUTPUT DEYICE OR FILE: TI@e 
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ID 


oOodgL2 
OOB89 1 
02943 
12643 


In this case, the Report Writer displays the report on the terminal. You can 
specify only one output device in a REPORT command. 


When you specify your output medium with an ON clause, the Report Writer 
advances to a new page after the report. If you do not use an ON statement, it 


TOP 


FIRST 
NAME 


CHARLOTTE 
FRED 
CASS 
JEFF 


ACHIEVERS 


LAST 
NAME 


OPIVA 
HOWL 
TERRY 
TASHKENT 


does not advance to a new page after the report. 


22-Apr-83 


Page li 


SALARY 


$79,892 
$59,594 
$29,908 
$32,918 
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Mastering Report Writing Techniques 3 


The Report Writer allows you to use a number of special techniques, such as 
these: 


Reporting on Groups of Records 


To report on groups of records, define your data file so your records are sorted 
automatically. Use an indexed file. 


If you want to sort the records differently for different reports, use the 
SORTED BY clause to tell the Report Writer how to sort the records. 


Reporting a Summary Only 


To produce a report made up of summary lines only, use the AT BOTTOM OF 
field-name statement. 


Printing a Title Page 


To print a complete title page before the body of the report, use the AT TOP oa 
REPORT statement. 


Printing Special Headings 


To produce special headings for successive pages of a report, use the AT TOP 
OF PAGE statement. 


Finding Totals within a Detail Line (Cross Tabulation) 


To add fields within a detail line, specify an additional print item that com- 


putes the total you want. 
Reporting List Fields 


To report list fields, form a collection with the FIND statement, and use an 
inner print list as an item in the PRINT statement. 


This chapter describes these techniques and illustrates them with sample 
reports. 


3.1. Dividing Data Records into Groups 
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You may often need to report on the groups of records within a body of data 
as well as on all the data. For example, you could report on employees sorted 
by department, with summary totals for each department as well as for all 
employees. | 


Groups of sorted records are control groups. A control group is a series of sorted 
data records that have the same value in one or more fields. The common field or 
fields “control” the forming of the group. 


3.1.1 Defining Key Fields to Optimize Speed of Processing 


Instead of requiring the Report Writer to sort the records (with the SORTED BY 
phrase), you can define your data file so the field you sort by most frequently is 
the primary key field. To define a data file for PERSONNEL with ID as the pri- 
mary key, use this command: 


DTR> DEFINE FILE FOR PERSONNEL:s KEY = ID@eD 


Defining such primary key fields is an effective optimization technique. The 
examples in the next section show how to use the SORTED BY phrase for cases 
where you have not defined a key field or want to sort by a field other than the 
key field. 


3.1.2 Developing Control Groups with a Sort Key 


When you sort a group of records, you choose at least one field as the basis for the 
sort. That field is called the sort key. Sometimes every record in a record stream 
has a unique value for the sort key. For example, every employee’s badge number 
is unique. When you sort employee records by the badge number, you create no 
control groups with two or more records because no two records have the same 
value in that field. 


In other cases, the number of unique values for a sort key may be small compared 
to the number of sorted records. For example, a company of 500 employees may 
have only 10 departments. That is, there are only 10 unique values for DEPT in 
the collection of 500 employee records. When you sort the employee records by 
the department code (DEPT), you create 10 control groups. DEPT would be a 
meaningful sort key for the grouping “employee records.” 


The following report statement establishes DEPT as the sort key for the records 
in the domain PERSONNEL: 


DTR> REPORT PERSONNEL SORTED BY DEPT@ED 
RW > 
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When you have completed the report specification, DATATRIEVE sorts the 


records according to the department code and processes the report: 


DTR> 
RW > 
RW > 
RW? 


ID 


12643 
49001 
87465 
90342 
J9029 
02943 
39485 
49843 
B4375 
38465 
48475 
00891 
32432 
#83923 
87701 
87289 
88001 
J1023 
344356 
38462 
48373 
83764 
OoOoO1L2 


DTR > 


Once you have sorted the records, you can use an AT TOP OF field-name or an 
AT BOTTOM OF field-name statement to emphasize the relationships among 
the sorted records. In the next example, an AT BOTTOM OF DEPT statement 


REPORT PERSONNEL SORTED BY 
SET COLUMNS_PAGE = 
PRINT PERSON@ED 


END_REPORT@ED 


STATUS 


TRAINEE 
APERTENCED 
APERTENCED 

EXPERIENCED 
APERTENCED 
APERTENCED 
APERTENCED 

TRAINEE 
APERTENCED 
APERTENCED 
APERTIENCED 

EXPERIENCED 

TRAINEE 
APERIENCED 

TRAINEE 
APERTENCED 
APERTENCED 

TRAINEE 

TRAINEE 
APERIENCED 

TRAINEE 

EXPERIENCED 
APERTENCED 


FIRST 
NAME 


JEFF 
DAN 
ANTHONY 
BRUNO 
RANDY 
CASS 
DEE 
BART 
MARY 
JOANNE 
GAIL 
FRED 
THOMAS 
LYDIA 
NATHANIEL 
LOUISE 
DAVID 
STAN 
HANK 
BILL 

SY 

JIM 
CHARLOTTE 


7 OGED 


DEPT @ED 


LAST 
NAME 


TASHKENT 
ROBERTS 
IACOBONE 
DONCHIKOY 


PODERESTIAN 


TERRY 
TERRICK 
HAMMER 
NALEYVO 
FREIBURG 
CASSIDY 
HOWL 
SCHWETK 
HARRISON 
CHONT2 
DEPALMA 
LITELLA 
WITTGEN 
MORRISON 
SWAY 
KELLER 
MEADER 
SPIVA 


DE P71, 


C82 
C82 
C82 
C82 
C82 
D998 
D8 
D8 
D8 
E46 
EdG 
Pad 
Plt 
Fil 
Fil 
G20 
G20 
G20 
Td2 
Td2 
T32 
T32 
TOP 


START 
DATE 


44-Apr-81 
77-Jul-79 
e-Jan-73 
9-Augs-78 
24-May-79 
e-Jan-80 
e-May-77 
4-Augs-81 
3g-Jan-76 
20-Feb-80 
22-May-78 
99-Apr-76 
77-Nov-81 
19-Jun-79 
28-Jan-82 
28-Feb-79 
11-Nov-80 
?3-Dec-81 
i-Mar-82 
o-Mary-80 
“-Aug-B1 
4-Apr-80 
12-Sep-72 


2e-Mar-83 
Page 1 


SALARY 


$32,918 
$41,395 
$58,462 
$35,952 
$33,738 
$29,908 
$55 ,829 
$26,392 
$56 +847 
$23,908 
$55,407 
$59,594 
$26+723 
$40,747 
$24,502 
$57,598 
$34,933 
$25,023 
$30,000 
$54,000 
$31,546 
$41,029 
$75,892 


SUP 
ID 


87465 
87465 
Oo012 
87465 
874635 
39485 
O001? 
39485 
394835 
48473 
O00? 
OOo 1.2 
o0891 
oOos8gi 
OoB8g1 
oO0012 
87289 
872789 
87289 
Ooo? 
87289 
97289 
Ooagts 


groups records according to department. Within the AT BOTTOM statement, you 
can use one or more statistical operators to summarize data about the employees 


in each control group. 


Example: Bock’s Yachts keeps salary records for employees in various depart- 
ments using the PERSONNEL domain. Report on all employees for selected 
departments within the company. Display the total salary for each department. 


Follow these steps: 


1. Sort the records according to the sort key DEPT to produce a group of 
employees for each department. 


2. Use an AT TOP OF DEPT statement to print the value for DEPT at the 
beginning of each DEPT control group. 
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3. Specify the values to be printed in each detail line. Use the concatenation 
expression (||“ ” |) to put exactly one space between the values for the first 
and last names. The double vertical line (|| ) suppresses the trailing spaces 
after the entry for FIRST_NAME. The space in quotation marks puts one 
space after FIRST_NAME. The single vertical line (|) causes LAST_NAME 

to print immediately after the one space. Specify a header (“NAME”). 


4. Summarize salary information for each department with an AT BOTTOM 
OF DEPT statement. TOTAL SALARY gives the total salary for a 
department. 


The following command file, SALRP1.CMD, incorporates these basic steps. 


DTRe @SALRPIQ@ED 
READY PERSONNEL 


REPORT PERSONNEL WITH DEPT = "D9O8", "EdG"> "T32" SORTED BY DEPT ———~{(1) 
SET REPORT_-NAME = "SALARY REPORT" . 
SET COLUMNS_PAGE = G0 
AT TOP OF DEPT PRINT DERE] AHH ——W——_________________y 
PRINT ID» FIRST UNAME: +" "TLAST_NAME ("NAME") » SALARY ——__—___________8) 
AT BOTTOM OF DEPT PRINT SKIP» 

COL 34+ DEPTii" "i"TOTAL: "+ 


TOTAL SALARY USING $$4$$ +5$94$ — 


END_REPORT 


SALARY REPORT 99-Mar-83 
Page 1 
DEPT ID NAME SALARY 
DOB 
O2943 CASS TERRY $29,908 
39485 DEE TERRICK $355 +829 
49843 BART HAMMER $26,392 
B4375 MARY NALEYO $56,847 
B98 TOTAL: $168,976 
Ed6 
38465 JOANNE FREIBURG $23,908 
48475 GAIL CASSIDY $55,407 
E4G TOTAL: $79,315 
T32 
34456 HANK MORRISON $30,000 
38462 BILL SWAY $354,000 
48373 SY KELLER © $31,546 
83764 JIM MEADER $41,029 


DTR? 


T32 TOTAL: 


$156 °9575 


3.1.3. Developing Levels of Control Groups Using Multiple Sort Keys 


The last example used one sort key to establish control groups, with each mem- 
ber of the group having the same value for the key field. There may also be times 
when you wish to identify groups within these control groups. One control group 
can contain other control groups. 
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For example, you could sort a personnel file by department and type of employee. 


Example: Two categories of employees work at Bock’s Yachts, experienced 
workers and trainees. The STATUS field takes one of two values: “Experienced” 
or “Trainee ”. Report salaries for each department, and for each type of employee 
within a given department. 


Follow these steps: 
1. Sort the records according to two sort keys, DEPT and STATUS. 


2. Use AT TOP OF DEPT and AT TOP OF STATUS statements to set up spe- 
cial headings for the control groups. 


3. Print the field values of the detail line. Use a concatenation expression 
(FIRST_NAME ||“ ” | LAST. NAME) to allow exactly one space between 
FIRST_NAME and LAST_NAME. Specify a header for the full name 
(“NAME”). 


4. Use AT BOTTOM OF DEPT and AT BOTTOM OF STATUS statements to 
print summary lines for each control group. 


5. Summarize the entire report with an AT BOTTOM OF REPORT statement. 


The report specification follows these basic steps to produce a double-control- 
break report, that is, a report with two sort keys. It forms a new sort order each 
time there is a change for “DEPT” (the first control break), and for “STATUS” 
(the second). For brevity, this report shows only employees in departments D98 
and T32. 


The procedure SALARY_REPORT2 contains the following report specification: 


DTR> SHOW SALARY REPORT 2@Ep 

PROCEDURE SALARY REPORT2 

READY PERSONNEL 

REPORT PERSONNEL WITH DEPT = "D98">» "T32" SORTED BY DEPT, STATUS —(1) 
SET REPORT_NAME = "DETAILED SALARY REPORT" 

SET COLUMNS_PAGE = 70 


AT TOP OF DEPT PRINT DEPT 

AT TOP OF STATUS PRINT Se ne 

PRINT ID» FIRST.NAME:!" "{LAST_NAME ("NAME") + SALARY—————————@) 

AT BOTTOM OF STATUS PRINT SKIP» COL 38; 
STATUS! !" "I"TOTAL:"» TOTAL SALARY USING 
$1+$$$,$$$, SKIP 

AT BOTTOM OF DEPT PRINT COL 36; 





"DEPARTMENT "iDEPTii:” TOTAL:"» 
TOTAL SALARY USING $+$SS SHS 5 
Us IR Tce ene ea eel ag eh "y+ SKIP 


AT BOTTOM OF REPORT PRINT COL 15, 
"EEK KEKE KEKE KEE KEKE EEE EEE KE REE KERR KEE KEKE EE" 5 
SKIP 2, COL 38+ "GRAND TOTAL SALARY:": 
TOTAL SALARY USING $+$S% s$4¢ 


END_REPORT 
END. PROCEDURE 
DTR?> : SALARY REPORT 2@ep 
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DEPT STATUS 


D938 
EXPER TENCED 


TRAINEE 


T32 
XPERTENCED 


TRAINEE 


DETAILED SALARY REPORT 


ID 


02943 
39485 
84375 


49843 


38462 
83764 


34436 
48373 


NAME 


CASS TERRY 
DEE TERRICK 
MARY NALEVO 


APERIENCED TOTAL: 


BART HAMMER 


TRAINEE TOTAL: 


DEPARTMENT D98 TOTAL: 


BILL SWAY 
JIM MEADER 


EXPERIENCED TOTAL: 


HANK MORRISON 


SY KELLER 


TRAINEE TOTAL: 


DEPARTMENT T32 TOTAL: 


ath GOORD CREES GUETT HETTT ShinD GONG! GEeTT SENET ¢miih Githd SS000 queue cTTET ferTS Gmrah GTEC UNOTY erent 


KEKKEKEEHKEKEKEKEKKEEKKKRKEEKHEKREEHEKRKEEHEKEEKKEE 


DTR > 
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GRAND TOTAL SALARY: 


25-Jan-83 
Page j 


SALARY 


$29,908 
$99 +629 
$936 +847 


$142,984 


$26,392 


$26,392 


$168;+976 


$34,000 
$41 +029 


$93 9029 


$30,000 


$31,546 


$61 +546 


$156 +575 


The report looks like this if you change the order of the sort keys, putting 
STATUS before DEPT in your statement, but with the rest of the specification 


unchanged: 


STATUS 


EXPERIENCED 


TRAINEE 


DTR? 


DEPT 


D938 


DS3 


ID 


O2943 
39485 
B4375 


34436 
485373 


— ee ener 


DETAILED SALARY REPORT 


NAME 


CASS TERRY 
DEE TERRICK 
MARY NALEVO 


DEPARTMENT DOYS TOTAL: 


BILL SWAY 
JIM MEADER 


DEPARTMENT T32 TOTAL: 


eS TEPE COOtS tents Sem Gem om my pnrED corte cones Sri GEE eREEY GEE vere ences 


EXPERIENCED TOTAL: 


BART HAMMER 


DEPARTMENT DO8 TOTAL: 


ee eee 


HANK MORRISON 
SY KELLER 


DEPARTMENT T32 TOTAL: 


ee ee ee ee 


TRAINEE TOTAL: 


KEKREEKKKEKEKEEKKEKREEEKKEKKREKREREEHEKRKRKREKRHEHEE 


GRAND TOTAL SALARY: 


17-Jan-83 


Page Il 


SALARY 


$29,908 
$35,829 
$356,847 
$142,584 


$34 +000 
$41,029 
$93 +029 


$237 +613 


$26 +392 
$26,392 


$30,000 
$31,546 
$61 5546 


$87 +938 
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The Report Writer sorts first by the sort key that you list first. Within each of the 
control groups formed by that key, it sorts by a second sort key, and so on. It cre- 
ates a control break whenever there is a change in field value for the sort key. 


If you are reporting on sorted records and do not call for explicit control breaks 
in the AT TOP or AT BOTTOM statements, the Report Writer does not supply 
breaks. If you want a field break when a value changes, you must include an 
explicit AT TOP OF field or AT BOTTOM OF field statement. 


When it is printing the values for a given control group, the Report Writer con- 


‘tinues printing until it reaches the end of the group, even if it must run over to a 


second page to do so. 
3.1.4 Using Control Breaks on Unsorted Records 


You may decide to use AT TOP and AT BOTTOM statements on records you have 
not sorted with DATATRIEVE. If you are reporting on: 


e An indexed file, the Report Writer processes the records according to the 
ascending order of the primary key value 


e A sequential file, the Report Writer processes records in the order they were 
stored 


When you use AT statements with records you have not sorted using 
DATATRIEVE, the Report Writer produces the report, but it sends the 
following message: 


Proceeding to report unsorted records 


If you are using more than one AT TOP statement or AT BOTTOM statement, 
you should specify the control breaks in this order: 


RM> AT TOP OF field-1l 
RW? AT TOP OF field-2 
RW? AT BOTTOM OF field-2 
RW AT BOTTOM OF field-i 


3.1.5 Reporting Group Summaries Only 


Control groups allow you to separate groups of detail lines and to print group 
summaries. Sometimes you may want only the summary information for the 
groups. It is possible to produce a report with summary lines and no detail lines, 
using the Report Writer or the SUM statement. 


You can produce a report consisting of only summary lines for control groups 
with the AT BOTTOM OF field-name statement. 


Example: Report salary information for each department in Bock’s Yachts. 
Include the number of employees in each department, the total salary, and the 
average salary. Finally, for the entire company, show the total number of 
employees, total salary, and average salary. 
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Follow these steps: 
1. Specify a sort key for the REPORT statement. 


2. Use AT BOTTOM OF DEPT to print each line of the body of the report. Each 
line summarizes a different department. Do not use the PRINT statement, 
because you are reporting on group totals, not on the individual members of 
the group. Use COUNT as a print item for the number of employees. 


3. Use AT BOTTOM OF REPORT for the aggregate summaries. COUNT pro- 
vides the total of all employees, because it represents the total of all records 
processed. 


The report specification that follows is contained in the command file 
TOTALS.CMD: 


DTR?: @TOTALS@ED 
READY PERSONNEL 
REPORT PERSONNEL SORTED BY DEPT 
SET COLUMNS PAGE = #."the columns Per Page" 
AT BOTTOM OF DEPT PRINT COL 10,» DEPT; 
COL 20, COUNT ("NUMBER"'/"EMPLOYEES") ; 
COL 35+ TOTAL SALARY ("TOTAL"/"SALARY")} USING $+$S$ $$$ » 
COL 50+ AVERAGE SALARY ("AVERAGE"/"SALARY") USING $$%$5¢9$ 
AT BOTTOM OF REPORT PRINT SKIP+ COL 10; 













THE KHE KEKE KEK KHER KEKE REE ERE EERE KEKE KEKE HERR KEE KKH EE" , 


SKIP 2+ COL 10+ "CORPORATE:", COL 22, COUNT, 

COL 34+, TOTAL SALARY USING $$ +S +$$¢¢ , 

COL 48, AVERAGE SALARY USING $+%$%,$%¢4 
END_UREPORT 


Enter the columns Per Pages G0O(ED 
99-Mar-83 
Page 1 
NUMBER TOTAL | AYERAGE 
DEPT EMPLOYEES SALARY SALARY 
C82 > $702,465 $40,493 
D8 | $168,976 $42,244 
E46 2 $79+315 $39,657 
Fil dj $151,566 $37,891 
G20 3 oe es Re ae ea ee 5 $39,184 
T32 d $156;575 $39,143 
TOP 1 $75,892 $75,892 


KEEEKEEKEKK EKER KEKE EERE EEK EERE KEKE EE KEKE EKEEESE 
CORPORATE: ad $952 +343 $41,406 


DTR> 
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By using AT TOP OF REPORT and AT TOP OF PAGE statements, you can 
enhance your reports with title pages and headings. | 


3.2.1. Printing a Title Page 


The AT TOP OF REPORT statement allows you to produce a title page before 
you produce any detail lines. When you use this statement, you suppress the 
default report heading on the first page of the report. You can then design the 
first page as a special title page without detail lines. The next page is “Page 1” 
and includes the report and column headers. 


Example: Report the salaries of employees at Bock’s Yachts. Produce a title page 
for the report. Include the company name, the warning “CONFIDENTIAL: FOR 
OFFICIAL EYES ONLY”, and the company motto. Do not print the date or page 
number until the next page of the report. Separate each item in the print list 
with a comma. Include NEW_PAGE as the last item of your print list to ensure 
that the first detail lines do not appear until the next page. 


The command file and title page look like this: 


DTR: @T PRE) 
READY PERSONNEL 
REPORT PERSONNEL WITH DEPT = "D98"+ "E46",> "T32" 
AT TOP OF REPORT PRINT SKIP 135; COL 20, 
"SS £ €£ & He HE He KH HH HF EF HE HE HH KH HEH HF KE EE" FSKIPS 
COL 20, "*#", COL SG» "*¥" y+SKIP» 
COL 20, "#", COL SG "*¥">+SKIP > 
COL 20, "*", COL B2, "SALARY REPORT" +s COL 356% "¥"+ 
COL 20% "“*¥", COL S36» "*">5 SKIP» 
COL 20, "*#", COL 30+ "FOR BOCK’S YACHTS":+ COL SG», "*¥", 
COL 20, "*", COL 3G, "¥"+s SKIP+s 
COL 20, "#", COL 3G, "*">+ SKIPs COL 20; 
"Ss £ £€ £ He HF HE HF HE HE HE HE He HE HE HF HH KE" GKIP By 
COL 32; "CONFIDENTIAL: "+ SKIP» 
COL 32, "FOR OFFICIAL"; SKIP+ 
COL 33, "EYES ONLY"+ SKIP 3; 


GUL. 200: Meret acietenceme Sue eae est see oe "SSKIP 3, 
COL 22, "OUR MOTTO: A YACHT FOR EVERY WORKER"» SKIP 3) 
CO. 20>. "tena tame eee ees ", NEW_PAGE 
SET COLUMNS_PAGE = 70 
PRINT ID+ STATUS, FIRST_NAME!}!" "!LASTLNAME ("NAME") + 


DEPT+ SALARY 
END_REPORT 
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Here is the title page. The body of the report is on the next page: 


i i i i a i, Se a a a a, a a a 


SALARY REPORT 


FOR BOCK ’S YACHTS 


OK OK OK OK OK Ok OK 
* OK OK OK Ok kK OK K & 


%* &£ &©& & EF EF Fe EF F HF HF KF HF OF OF OF OF 


CONFIDENTIAL: 
FOR OFFICIAL 
EYES ONLY 


OUR MOTTO: A YACHT FOR EVERY WORKER 
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ID 


O2943 
34456 
38462 
38465 
39485 
48475 
489373 
49843 
83764 
84375 


DTR> 


18-Jan-83 


Page 2 
STATUS . NAME DEPT SALARY 
XPERTIENCED CASS TERRY D8 $29,908 
TRAINEE HANK MORRISON T32: $30,000 
EXPERIENCED BILL SWAY T32 $54,000 
EXPERIENCED JOANNE FREIBURG E4G $23,908 
XPERIENCED DEE TERRICK : DOB $35 +829 
XPERTENCED GAIL CASSIDY E46 $55 +407 
TRAINEE SY KELLER T32 $31,546 
TRAINEE BART HAMMER DIB $26,392 — 
XPERIENCED JIM MEADER T32 $41,029 
XPERTENCED MARY NALEYWO D8 $56 +847 


3.2.2 Printing Special Page Headings 


With the AT TOP OF PAGE statement you can print special headings for your 
report. When you use the AT TOP OF PAGE statement, you suppress the default 
report and column headings on every page. If you want either of these headings 
on the page, you must include REPORT. HEADER or COLUMN_HEADER as 
part of the print list for the AT TOP OF PAGE statement. 


Example: Produce the salary report for Bock’s yachts without a title page, but 
with the report heading: “SALARY REPORT FOR BOCK’S YACHTS”, sur- | 
rounded by asterisks. Include the date and page number, as well as the appropri- 
ate column headings: 


DTR* @PGHEAD@ED 

READY PERSONNEL 

REPORT PERSONNEL WITH DEPT = "DOB", "EdG"s "Toe" 
SET COLUMNS_PAGE = 706 | 

AT TOP OF PAGE PRINT REPORT_HEADER:+ SKIP 2» 


COL 2O, "* * * * ¥ & Fe HE HE EH HF HF KH KH HF KF HE" SKIP » 
COL 20, "*", COL S36» "*"» SKIP» 

COL 20+ "*#"5, COL SG "*"s SKIP» 

COL 20,5 "*¥"» COL 32+ "SALARY REPORT" +», COL SG» "*¥";4 
COL 20% "*", COL SGs "#"5 SKIP» 

COL 20+ "*"y5y COL 30, "FOR BOCK’S YACHTS";>COL 3G, "#", 
COL 20% "*¥",», COL SG "#"s SKIP» 

COL 20+ "#"5 COL 5G, "#"»5 SKIPs COL 20, 


"% £ € eH He HK Ke KH KH Ke Ke HK KH KH HRN, 
SKIP 3+ COLUMN_HEADER 

PRINT ID+ STATUS+ FIRST NAME: ;" "iLAST-NAME ("NAME") » 
DEPT» SALARY 

ENDL REPORT 
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ID 


02943 
34456 
38462 
38465 
39485 
48475 
48373 
49843 
83764 
84375 


DTR> 


2d-Jul-B83 


Page 1 

* + © EF HF HF HF HF KF EF H HF HR H HF KH H H 

% ¥ 

€ ¥ 

¥% SALARY REPORT % 

% ¥ 

# FOR BOCK ’S YACHTS ¥ 

x % 

% 

Ee Ee KE KF HK KE HE Ke HF HK KK HK Ke KH * 
STATUS NAME DEPT SALARY 
XPERTENCED CASS TERRY D98 $279,908 
TRAINEE HANK MORRISON T32 $30,000 
EXPERIENCED BILL SWAY T32 $34,000 
XPERTENCED JOANNE FREIBURG Edo $23,908 
XPERIENCED DEE TERRICK . D98 $55 +829 
EXPERIENCED GAIL CASSIDY E46 $33 +5407 
TRAINEE SY KELLER T32 $31+546 
TRAINEE BART HAMMER D98 $26,392 
XPERTENCED JIM MEADER T32 $41,029 
EXPERTENCED MARY NALEYVO D98 $36,847 


Note that the REPORT_HEADER print item produces both the date and page 
number. Then, after skipping three lines, the Report Writer prints the special 
heading as specified in the AT TOP OF PAGE statement. If the report had sev- 
eral pages, each successive page would have the special heading. 


Using REPORT_HEADER along with the AT TOP OF PAGE statement, you 
could design a special billing form with the company heading, with labels for 
charges and charge descriptions. If the data for each bill was in a single record, 
you could include NEW_PAGE as the last print item in the PRINT statement. 
Then each page would contain one customer’s bill. 


You could also apply this technique to duplicate an existing standard form. 
Specify the appropriate character strings, column numbers, and field values as 
print list items. Finally, include NEW_PAGE as the last print list item. 


3.3. Performing Cross Tabulations 


Reports sometimes require totals of the fields within a detail line. For example, 
for the domain YACHTS, the field DISPLACEMENT is related to the field 
PRICE. You might want to design a report to print a detail line for each boat 
showing builder, model, and price. Perhaps a buyer wants to know the individual 
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prices for a number of boats, the combined price for all the boats, and the price for 
the boats after the next increase. To compute the scheduled new price, you need 
to apply a price increase formula to each detail line. 


Specify an additional print item for the detail line by indicating the formula for 
the scheduled price increase. The Report Writer then produces a column of totals 
for each row. 


The following example uses the domain YACHTS. 


Example: Bock’s Yachts maintains pricing records for its semiannual increases. 
Report on each boat’s price, indicating the scheduled new price. Then, for the first 
fifteen boats, calculate the total price and the total new price. Use the equation 
(DISP/10) + PRICE to find the new price. Compute the totals of the field values 
with an AT BOTTOM OF REPORT statement. 


Enter the steps for the report in a command file called PR.CMD. When you 
execute the command file, you get this report: 


DTR? @PR@ED 

READY YACHTS 

FIND FIRST 15 YACHTS WITH PRICE NE © 

[iS records found] 

REPORT CURRENT 

SET REPORT_NAME = "BOCK’S FAMOUS YACHTS"/ 
"SEMIANNUAL PRICE CATALOGUE" 

SET COLUMNS_PAGE = 70 

PRINT BUILDER+ MODEL, PRICE, COL 37» 

(DISP/10) + PRICE ("NEW PRICE") USING $$% +$$% 

AT BOTTOM OF REPORT PRINT SKIP 2+ COL 1+ "“TOTAL:"+ 
TOTAL PRICE USING $$$ +$$$+$%$$, COL 34, 
TOTAL ((DISP/10) + PRICE) USING $84 +446 5$$% 

END_REPORT 


BOCK ’S FAMOUS YACHTS i8-Jan-8 
SEMIANNUAL PRICE CATALOGUE Page 1 
MANUFACTURER MODEL PRICE NEW PRICE 
ALBERG 37 MK II $36;951 $38,951 
ALBIN 79 $17,900 $18+320 ~ 
ALBIN BALLAD $27 +300 $26 +227 
ALBIN VEGA $18,600 $19,107 
AMERICAN | 26 $9,895 $107299 
AMERICAN 26-MS $18,895 $19+445 
BAYFIELD 30/32 $32,875 $33,825 
BOMBAY CE IPPER $239,930 $24;890 
CAPE DORY 20 $8,995 $9+395 
CAPE DORY 28 $21,990 $22,890 
CAPE DORY TYPHOON $4,290 $4,485 
CARIBBEAN 3o $37 +850 $39 +650 
CHALLENGER oe $31+895 $33+115 
CHALLENGER go $39 +215 $40;695 
CHALLENGER 41 $51 +228 $33 ,+898 
TOTAL: $381,974 $397+188 


DTR > 
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An alternate solution is to edit the record definition and add anew COMPUTED 
BY field, NEW_PRICE. Then include NEW_PRICE as one of the print items in 
the PRINT statement. The following is a sample field definition: 


10 NEWUPRICE COMPUTED BY 


(DISP/10) + PRICE 
EDIT_STRING IS $$% »$$4, 


Using a COMPUTED BY field saves typing if you need the value for the new 
price in several different reports. Then if the formula changes, you have to 
change it only in the record definition. 


3.4 Reporting Hierarchical Records 


A hierarchical record is a record that contains a list. The list field uses an 
OCCURS clause to specify the number of items in the list. Each list item is subor- 
dinate to the list field, on a lower logical level than the other fields of the record. 


Figure 3-1 illustrates the structure of the hierarchical record FAMILY_REC. 


01 FAMILY 


03 PARENTS 03 NUMBER_ KIDS 03 KIDS 
OCCURS 0 TO 10 TIMES 
DEPENDING ON NUMBER_KIDS 























06 FATHER }| 06 MOTHER 










06 EACH_KID 





Figure 3-1: Field Structure of FAMILY_REC 


The OCCURS clause of a hierarchical record designates either a fixed-length or a 
variable-length list. For variable-length lists, the list field’s definition includes 
an OCCURS DEPENDING clause stating that the number of items in the list 
depends on the value of another field. For example, the length of the KIDS list in 
FAMILY REC depends on the value stored in EKACH_KID. 
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Here is the record definition for FAMILY _REC: 


RECORD FAMILY_REC 
USING 
Ol FAMILY, 
03 PARENTS. 
| QO6 FATHER PIC K(10). 
OG MOTHER PIC x(10). 
O3 NUMBER_KIDS PIC 99 EDIT_STRING [5 29, 
O3 KIDS OCCURS 0 TQ 10 TIMES DEPENDING ON NUMBER_KIDS. 
OG EACH_KID,. 
O9 KIDUNAME PIC K(10) QUERY NAME IS KID. 
O98 AGE PIC 99 EDIT_STRING IS 29, 


a 
4 


If you have a domain with hierarchical records, you may want access to individ- 
ual items from the list to compare their values or to find associated values on a 
table. 


To provide DATATRIEVE with the proper context for each list item, you can use 
nested FOR statements outside of the Report Writer. 


To print the names of the children from FAMILIES, for instance, you cannot sim- 
ply say PRINT KID_ NAME. You must provide a context. In the following exam- 
ple the first FOR statement, FOR FIRST 3 FAMILIES, instructs DATATRIEVE 
to process the first 3 records from FAMILIES one record at a time. The second 
FOR statement, FOR KIDS, tells it to process the KIDS list for each family 
record. 


DTR?> READY FAMILIES@E) 

DTR? SET NO PROMPT@ED 

DTR? FOR FIRST 3 FAMILIES@E 
CON? FOR KIDS@eED 

CON? PRINT KID_NAME@ED 


KID 
NAME 


URSULA 
RALPH 
ANNE 
JIM 
ELLEN 
DAVID 
ROBERT 
ANN 
JEAN 


DTR? 


For more information on context in DATATRIEVE, see the DATATRIEVE-11 
User’s Guide. 
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DTR> 
DTR> 
[id 
DTR> 
RW > 
RW > 
RW > 


DTR? 


To list items from within the Report Writer, first form a collection of the records 
you will use. In the PRINT statement, precede items from the list with ALL and 
follow them with OF and an RSE specifying the source of the items: 


READY FAMILIES@ED 


FIND FAMILIES@E& 
records found 
REPORTED 


PRINT MOTHER+ FATHER,» 


SET REPORT NAME 
END_REPORT@ED 


MOTHER 
ANN 


EGU Lor 


JULIE 


ELLEN 
ANNE 


SARAH 
ANNE 


MERIDETH 


DIDI 
RUTH 


BETTY 
‘LOIS 
SARAH 


TRINITA 


ALL KID.NAME OF KIDS@ED 
“ANNUAL PICNIC ROSTER" @E) 


ANNUAL PICNIC ROSTER 


FATHER 
JIM 


JIM 


JOHN 


JOHN 
ARNIE 


SHEARMAN 
“TOM, 


BASIL 


ROB 
JEROME 


TOM 
GEORGE 
HAROLD 


EDWIN 


9-Mar-83 
Page l 


KID 
NAME 


URSULA 
RALPH 
ANNE 
JIM 
ELLEN 
DAVID 
ROBERT 
ANN 
JEAN 
CHRISTOPHR 
SCOTT 
BRIAN 
DAVID 
PATRICK 
SUZIE 
BEAU 
BROOKS 
ROBIN 
JAY 
WREN 
JILL 


ERIC 
CISsy 
NANCY 
MICHAEL 
MARTHA 
TOM 
JEFF 
FRED 
LAURA 
CHARLIE 
HAROLD 
SARAH 
ERIC 
SCOTT 
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If you were planning the games for the picnic, you might want a report of just the 
kids between five and twenty years old. You could specify the report like this: 


DTR? READY FAMILIES@E 

DTR* FIND FAMILIES WITH ANY KIDS WITH AGE BT 3 AND 20@H 

CG records found] 

DTR?> REPORT CURRENT@ED 

RW? PRINT ALL KIDUNAME;+ AGE OF KIDS WITH AGE BT 3 AND 20@E 
RW> SET REPORTUNAME = "SACK RACE CANDIDATES" en 

RW? ENDUREPORTQ@ED 


SACK RACE CANDIDATES o-May-83 
Page l 
KID 
NAME AGE 
URSULA 7 
ROBERT 16 
SUZIE 6 
WREN 17 
ra ie ey cae 
MICHAEL 20 
ERIC 16 
SCOTT 5 | 


DTR? 


Dividing data into groups, printing title pages, performing cross tabulations, 
and reporting hierarchical records are some of the advanced Report Writer tech- 
niques you may want to use. If you wish to develop additional techniques of your 
own, refer to the DATATRIEVE-11 Reference Manual for asummary of the syn- 
tax for Report Writer statements. 
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This appendix contains copies of the original data for the YACHTS, 


Data Files Supplied with DATATRIEVE-11 A | 


FAMILIES, and PERSONNEL domains. If the files you have in your directory 
do not match these in any way, you may get different results from those 
shown in the examples in this book. To display the data you have in your 


files, just ready the domain and use the PRINT statement: 


DTR> READY 
DTR* PRINT 


YACHTS 
YACHTS 


A.1 YACHTS Domain Data 
MANUFACTURER MODEL 
ALBERG 37 MK II 
ALBIN 79 
ALBIN BALLAD 
ALBIN VEGA 
AMERICAN 26 
AMERICAN <6-MS 
BAYFIELD 30/32 
BLOCK I. 4o 
BOMBAY CLIPPER 
BUCCANEER 2/70 
BUCCANEER 320 
C&C CORVETTE 
CABOT 36 
CAL 2-27 
CAL 2-34 
CAL 2% 
CAL 3-30 
CAL So 
CAPE DORY 20 
CAPE DORY 283 
CAPE DORY TYPHOON 
CAPITAL NEWPORT 


RIG 


KETCH 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
MS 

SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 


LENGTH 
OVER 
ALL 


37 
26 
30 
re | 
26 
26 
32 
39 
31 
a/ 
32 
ce 
36 
ra 
33 
29) 
30 
3o 
20 
28 
19 
28 


WE TGHT 


20;s000 
As200 
79276 
39070 
43oo0o0 
oO +900 
9300 
18 +500 
9+400 
S000 
12300 
8,650 
15,000 
6 +700 
93300 
8 +000 
10,500 
15,000 
4,000 
7,000 
1*900 
7 +000 


BEAM 


2 
10 
10 
08 
08 
O08 
10 
12 
11 
08 
10 
og 
12 
Og 
10 
O9 
10 
1i 
07 
OS 
OG 
Od 


PRICE 


$36;951 
$17,900 
$27 5300 
$18,600 
$9,s895 
$18,895 
$32;875 


$23 +950 


$8,995 
$21,990 
$4 5295 


MANUFACTURER 


CARIBBEAN 
CHALLENGER 
CHALLENGER 
~ CHALLENGER 
CHRIS-CRAF 
COLUMBIA 
COLUMBIA 
COLUMBIA 


~ DOUGLAS 


- DOWN EAST 
DOWN EAST 
DUFOUR 
EASTWARD 
ENCHILADA 
ENDEAVOUR 
ERICSON 
ERICSON 

_ FISHER 
FISHER 
FJORD 
GRAMPIAN 
GRAMPIAN 
GRAMPIAN 
GRAMPIAN 
GRAMPIAN 
GULFSTAR 
HUNTER 
HUNTER 

I. TRADER 
IRWIN 
IRWIN 
IRWIN 
IRWIN 
ISLANDER 
ISLANDER 
ISLANDER 
ISLANDER 
ISLANDER 
LINDSEY 
MARIEHOLD 
METALMAST 
MOODY 
NAUTOR 
NEWPORT 
NEWPORT 
NEWPORT 
NICHOLSON 
NORTHERN 
NORTHERN 
O’DAY 
O’DAY 
OLYMPIC 
ONTARIO 
ONTARIO 
PACESHIP 
PEARSON 
PEARSON 
PEARSON 
PEARSON 
PEARSON 
PEARSON 


MODEL 


35 

32 

33 

41 
CARIBBEAN 
ao 

41 

PAYNE 9.6 
32 

32 

38 

oO 

HO 

20 

32: 

<3/ SPECIA 
CRUISING/3 
30 

37 

MS 33 
2-34 

<6 


298 


30 

34 

41 

Z? 

30 

37 

20 

30 

37 MARK II 
HALF TON 
28 

30 

3G 
BAHAMA 
FREEPORT 
39 

32 
GALAKY 
33 

SWAN 41 
275 

30 II 
415 

33 

29 

37 

27 

d2 
ADVENTURE 
a2 
VIKING 
PY26 

10M 

26 

26W 

28 

30 

35 


RIG 


SLOOP 
SLOOP 


SLOOP 


-KETCH 


SLOOP 
SLOOP 
oLOOP 
SLOOP 
oLOOP 
SLOOP 
SLOOP 
SLOOP 


SLOOP 
SLOOP 
SLOOP 
SLOOP 
KETCH 
KETCH 


SLOOP 


SLOOP 


‘SLOOP 


SLOOP 


KETCH 


KETCH 
SLOOP 
SLOOP 
KETCH 
SLOOP 
SLOOP 
KETCH 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
KETCH 
MS 

SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
KETCH 
SLOOP 
SLOOP 
KETCH 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
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LENGTH 
OVER 
ALL 


35 
32 
30 
41 
3 
33 
Ai 
32 
32 
32 
38 
a0 
2d 
20 
32 
20 
36 
30 


Zo 
30 
37 
30) 
28 
30 
36 
24 
Ai 
jv 
31 
x 
33 
Ai 
27 
30 
41 
ae 
29 
7 
27 
oe 
42 
32 
34 
26 
33 
26 
26 
29 
30 
oo 


WEIGHT 


18,000 
12,800 
14;800 
26 +700 
18,000 
115350 
204700 
1047200 
10 +300 
15,000 
19.500 
2 +700 
7,000 
29300 
11+700 
3100 
16;000 


"145500 


30,000 
14+000 
11,800 
29600 
6,900 
8 +600 
12-2000 
22,000 
6300 
9,500 
18 +600 
2 #400 
10,000 
20,000 
74300 
29994 
B»GOO 
135450 
43200 
227000 
14,500 
8,000 
9,500 
199323 
173730 
6,000 
B,O00 
18,000 
10,046 
7 92nd 
14,000 
2 #900 
11,000 
24250 
9,500 
8,807 
6 +000 
12,441 
2 +400 
39200 
7 +830 
8+320 
13,000 


BEAM 


11 
ie 
12 
13 
V1 
10 
ii 
16 
09 
ii 
12 
O8 
og 
07 
10 
O8 
Ll2 
09 


” 
res 


11 
10 
08 
10 
Og 
10 
12 
Og 
10 
12 
12 
10 
11 
10 
10 
10 
iat | 
08 
13 
12 
10 
OO 
1i 
12 
Og 
10 
11 
10 
Og 
11 
09 
OOo 
13 
11 
10 
10 
11 
08 
O09 
09 
09 
10 


PRICE 


$37,850 
$31,835 
$39 +215 
$51,228 
$37,850 


$48 +490 


$15 +900 


$29+675 
$11+495 
$14,475 
$17+775 
$29,675 
$41+350 
$14,999 
$21,500 
$39,500. 
$10,950 
$19,950 
$36 950 


$135;+908 
$20,990 
$31+730 
$6 +500 
$34,970 
$35,900 


$20+979 
$50,000 


$29,500 
$80,500 


MANUFACTURER 


PEARSON 
PEARSON 
PEARSON 
PEARSON 
RANGER 
RANGER 
RANGER 
RANGER 
RHODES 
ROBERTS 
ROBERTS 
ROGGER FD 
RYDER 

$2 

52 

SABRE 
SALT 

SAN JUAN 
SAN JUAN 
SCAMPI 
SOLNA CORP 
TA CHIAD 
TANZER 
TANZER 
VENTURE 
VENTURE 
WESTERLY 
WESTSAIL 
WINDPOWER 
WRIGHT 


FATHER 


JIM 


JIM 


JOHN 


JOHN 
ARNTE 


SHEARMAN 
TOM 


BASIL 


ROB 


MODEL 


36 

3635 

3g 

419g 

26 

28 

29 

33 
SWIFTSURE 
29 

36 

M/S 

S. CROSS 
BM AFT 
8M MID 
28 

19 

Zi 

26 

30 
SCAMPI 
FANTASIA 
26 

28 


21 


399 


. on 


CENTAUR 

ge 

IMPULSE 
SEAWIND [1 


A.2 FAMILIES Domain Data 


MOTHER 


ANN 


LOUISE 


JULTE 


ELLEN 
ANNE 


SARAH 
ANNE 


MERTIDETH 


DIDI 


RIG 


SLOOP 
KETCH 
SLOOP 
KETCH 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
MS 

SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 
SLOOP 


LENGTH 
OVER 


ALL 


37 
3G 
39) 
42 
26 
28 
29 
33 
33 
29 
37 
3 
31 
26 
26 
28 
20 
al 
26 
30 
30 - 
3O 
26 
28 


cl 
eae) 


26 
32 
16 
32 


NUMBER 
KIDS 


” 
rae 


a) 


oe trl 


hoe 


WEIGHT 


13+500 
17 +700 
17+000 
21+000 
~ +860 
22108 
G+7090 
190,500 
14,000 
9664 
14;750 
17 +600 
13 +600 
4,600 
29200 
7 +400 
21600 
12250 
4,400 
G6 +600 
6»600 
239200 
4,350 
6 »BOO 
1,500 
2,yO00 
6700 
19+S500 
630 
14,900 


KID 
NAME 


URSULA 
RALPH 
ANNE 
JIM 
ELLEN 
DAVID 
ROBERT 
ANN 
JEAN 
CHRISTOPHR 
SCOTT 
BRIAN 
DAVID 
PATRICK 
SUZIE 
BEAU 
BROOKS 
ROBIN 
JAY 
WRENN 
JILL 


BEAM 


et 
1i 
12 
13 
OS 
10 
og 
10 
10 
io 
11 
il 
ere) 
og 
og 
Og 
07 
O77 
08 
10 
10 
oOo 
og 
10 
07 
O7 
08 
1i 
07 


OO 


PRICE 


$32 9500 


$22 +000 
$6 +390 


$11730 
$17 +500 
$2 +823 
$3,364 
$15 +245 


$3 +900 
$34,480 


AGE 


31 
29 
26 
24 
16 
29g 


QO 


0 
's) 


28 
26 
24 


a 
oo 


17 


20 


Data Files Supplied with DATATRIEVE-11 A-3 


FATHER 


JEROME 


TOM 


GEORGE 


HAROLD 


EDWIN 


MOTHER 


RUTH 


BETTY 


LOIS 


SARAH 


TRINITA 


NUMBER 


A.3)> PERSONNEL Domain Data 


ID 


00012 
gooB91 
02943 
12643 
32432 
34456 
38462 
38465 
39485 
48475 
48373 
49001 
49843 
78923 
83764 
B4375 
87289 
87465 
87701 
BB001 
90342 
91023 
99029 


A-4 


STATUS 


XPERTIENCED 
XPERTIENCED 
XPERTENCED 
TRAINEE 
TRAINEE 
TRAINEE 
XPERTIENCED 
XAPERIENCED 
XPERTENCED 
XPERIENCED 
TRAINEE 
XPERTIENCED 
TRAINEE 
APERTENCED 
APERIENCED 
APERTENCED 
APERTENCED 
XPERIENCED 
TRAINEE 
APERIENCED 
XPERTENCED 
TRAINEE 
APERTENCED 


FIRST 
NAME 


CHARLOTTE 
FRED 
CASS 
JEFF 
THOMAS 
HANK 
BILL 
JOANNE 
DEE 
GATL 

of 

DAN 
BART 
LYDIA 
JIM 
MARY 
LOUISE 
ANTHONY 
NATHANTEL 
DAVID 
BRUNO 
STAN 
RANDY 


KIDS 
Al 
3 
| 
LAST 
NAME DEPT 
SPIVA TOP 
HOWL Fil 
TERRY DIS 
TASHKENT C82 
SCHWEIK Fil 
MORRISON T32 
SWAY T32 
FREIBURG EdG 
TERRICK DOS 
CASSIDY E46 
KELLER T32 
ROBERTS C82 
HAMMER D98 
HARRISON Fil 
MEADER T32 
NALEVO D98 
DEPALMA G20 
TACOBONE C82 
CHONTZ Fil 
LITELLA G20 
DONCHIKOYW C82 
WITTGEN G20 
PODERESIAN C82 


Data Files Supplied with DATATRIEVE—11 


KID 
NAME 


ERIC 
Cissy 
NANCY 
MICHAEL 
MARTHA 
TOM 
JEP Er 
FRED 
LAURA 
CHARLIE 
HAROLD 
SARAH 
ERIC 
SCOTT 


START 
DATE 


12-Ser-72 
9-Apr-76 
e-Jan-80 
4-Apr-81 
7-Nou-81 
1-Mar-82 
o-May-80 
20O-Feb-80 
2-May-77 
“-May-78 
2£-AuUdS-8l 
77-Jul-79 
4-Ang-B1 
19-Jun-79 
44-Apr-80 
33-Jan-76 
£8-Feb-79 
e-Jan-73 
28-Jan-82 
11-Nov-80 
9-Aug-78 
23-Dec-8681 
24-May-79 


AGE 

32 

2d 

Le 

Fal) 

30 

a7 

al 

3o 

16 

ii 

SUP 

SALARY ID 
$73,892 o0012 | 
$39,594 00012 
$29,908 39485 
$32,918 87465 
$267,723 00891 
$30,000 87289 
$54,000 O0012 
$23,908 48475 
$355,829 00012 
$55 +407 o0oo12 
$31,546 87289 
$41,395 874635 
$26,392 39485 
$40,747 o0ogsgi 
$41,029 87289 
$56,847 39485 
$37,598 oo0012 
$3568;462 00012 
$24,302 00891 
$34;933 87289 
$39,952 87465 
$25,023 87289 
$33+738 87465 


A 


AT BOTTOM statement (Report Writer) 
OF field-name, 2-17, 3-3, 3-8 to 3-9 
OF PAGE, 2-17 
OF REPORT, 2-17, 2-18, 3-14 

AT TOP statement (Report Writer) 

OF field-name, 3-3 
OF PAGE, 2-17, 3-10 to 3-13 
OF REPORT, 2-17 
AVERAGE statistical function, 1-9, 2-17 
to 2-18 


C 


Column headers, 2-10, 2-15 to 2-17 
specifying, 2-16 to 2-17 
suppressing, 2-15 
wrapping, 2-13 

COLUMN_HEADER, 3-12 

Command files, 2-18 to 2-19 

Concatenated expressions, 3-4 

Control groups, 3-2 to 3-9 
levels of, 3-4 to 3-8 
sort keys, 3-2 to 3-8 
without sort keys, 3-8 

COUNT statistical function, 1-9, 2-17 to 

2-18 
Cross tabulations, 3-13 to 3-14 


Index 


D 


Dates 

suppressing, 2-10 
DEFINE PROCEDURE command, 1-6 
Detail lines, 2-10 to 2-17 

content, 2-11 to 2-12 

format, 2-12 to 2-15 


_ Displaying reports, 1-4 


E 


Edit strings, 2-14 to 2-15 
text edit strings, 2-15 
Elementary fields, 2-11 
END_REPORT statement (Report 
Writer), 1-4, 1-5, 1-7 


F 


Field values 

in detail lines, 2-11 to 2-12 
FIND statement, 2-2 
FINISH command, 1-7 
FOR statement, 3-16 
Form feed 

trailing, 2-3 
Formatting output 

default, 2-2, 2-4 

report header, 2-7 

reports, 1-4 


Index-1 


G 
Group fields, 2-11 
H 


Hierarchical records, 3-15 to 3-18 
Hyphen (-), 2-15, 2-16 


Invoking 
procedures, 1-7 


L 


Lists 

printing, 3-17 to 3-18 
Literals, 2-12 

in detail lines, 2-11 


MAX statistical function, 2-18 to 2-19 
MIN statistical function, 2-18 to 2-19 


N 


Naming reports, 1-4 
NEW_PAGE, 3-10, 3-13 


O 


OCCURS clause, 3-15 


p 


Page format, 2-4 to 2-7 
length, 2-6 
width, 1-6, 2-2, 2-5 
Page numbers, 2-7 
suppressing, 2-10 
Print items 
column position of, 2-13 to 2-14 
cross tabulations, 3-14 
edit string format, 2-14 to 2-15 
order of, 2-13 
PRINT statement (Report Writer), 1-3, 
1-3, 1-4, 2-1 
detail lines, 2-11 
order of print items, 2-13 
Procedures 
for reports, 2-19 


Index-2 


Prompting value expressions, 1-6 to 1-7, 
2-12 
as print item, 2-11 
for page width, 2-5 
for report length, 2-6 
Prompts 
RW>, 1-5 


R 


READY command, 2-2 
Report header, 2-7 to 2-10 
REPORT statement, 1-4, 1-5, 2-1, 2-2 
to 2-3 
identifying data, 2-2 
selecting output medium, 2-19 to 2-21 
default, 2-20 
file, 2-20 
printer, 2-20 
prompt option, 2-20 
terminal, 2-20 
Report Writer 
invoking, 1-5, 2-2 to 2-3 
REPORT_HEADER, 3-12, 3-13 
Reports 
cross tabulations, 3-13 to 3-14 
dating, 2-7, 2-9 
designing, 2-1 to 2-21 
hierarchical records, 3-15 to 3-16 
naming, 2-1, 2-7 
page numbers, 2-7 
periodic, 1-1 
query, 1-1 
sample, 1-2 
special page headings, 3-12 to 3-13 
specification, 1-4 to 1-5, 2-1 to 2-2 
title page, 3-10 to 3-12 


S 


Sample report, 1-2 

Saving reports 
using command files, 1-7 to 1-8 
using procedures, 1-6 to 1-7 

SET NO PROMPT command, 1-3 

SET statement (Report Writer), 1-4 
COLUMNS_PAGE, 2-2, 2-5 
DATE, 2-9 
LINES_PAGE, 2-5 to 2-6 
MAX_LINES, 2-6 to 2-7 
MAX_PAGES, 2-6 to 2-7 
NO DATE, 2-10 
NO NUMBER, 2-10 
REPORT_NAME, 2-2, 2-7, 2-7 to 2-9 


SHOW FIELDS command, 1-5 
Slash (/), 2-8, 2-16 
Sort keys, 3-2 to 3-8 

multiple, 3-4 | 
SORTED BY clause, 3-2 to 3-8 
SPACH, 2-13, 2-14 
Special page headings, 3-12 to 3-13 
Statistical functions, 1-8 to 1-9, 2-12, 

2-17 to 2-19 

AVERAGE, 1-8, 2-17 

COUNT, 1-8, 2-17 

MAX, 1-8, 2-18 

MIN, 1-8, 2-18 

TOTAL, 1-8, 2-17 
SUM statement, 1-3, 1-3 to 1-4 
Summaries 

group, 3-8 to 3-9 
Summarizing data, 2-17 to 2-19 
Summary lines, 1-8 to 1-9, 2-17 to 2-19 
Summary statistics, 1-8 to 1-9 


T 


T (text) 
edit string character, 2-15 
TI 
for output to terminal, 2-20 
Title page, 3-10 
TOTAL statistical function, 2-17 to 2-18 


U 


USING clause, 2-12, 2-14 to 2-15 


V 


Value expressions 
in detail lines, 2-11, 2-12 
prompting, 1-6 to 1-7 
Variables, 2-12 
in detail lines, 2-11 


Index-3 


HOW TO ORDER ADDITIONAL DOCUMENTATION 


DIRECT TELEPHONE ORDERS 


In Continental USA In Canada In New Hampshire, 
and Puerto Rico call 800—267-—-6146 Alaska or Hawaii 
call 800—258—1710 call 603—884—6660 


DIRECT MAIL ORDERS (U.S. and Puerto Rico*) 
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This update contains changes and additions made to the 
DATATRIEVE-11 Guide to Writing Reports for Version 3.2. 


Instructions 


Place the enclosed pages in the DATATRIEVE-11 Guide to Writing 
Reports Version 3 as replacements for or additions to current pages. 
Change bars on replacement pages indicate changed text. For new 
pages and pages where most of the text has been substantially 
revised, no change bars are used. Instead, only the Version 3.2 
release date is shown on the bottom corner of the page. 


Old Page New Page 
Title Page/Copyright Title Page/Copyright 
How to Order How to Order 


Reader’s Comments/Mailer Reader’s Comments/Mailers 


DATATRIEVE-11 
Guide to Writing Reports 


Order No. AA-U051A-TK 
Including AD-U051A-T1 





November 1987 


This manual describes the DATATRIEVE-11 Report Writer. 


OPERATING SYSTEMS: RSX-11M 
RSX11M—PLUS 
RSTS/E 
Micro/RSX 
Micro/RSTS 
VMS with RSX-11 


SOFTWARE VERSION: DATATRIEVE-11 V3.2 


digital equipment corporation, maynard, massachusetts 


The information in this document is subject to change without notice and should 
not be construed as a commitment by Digital Equipment Corporation. Digital 
Equipment Corporation assumes no responsibility for any errors that may 
appear in this document. 


The software described in this document is furnished under a license and may be 
_ used or copied only in accordance with the terms of such license. 


No responsibility is assumed for the use or reliability of software on eduipment 
that is not supplied by DIGITAL or its affiliated companies. 


Copyright © 1983, 1987 by Digital Equipment Corporation. All Rights Reserved. 


The postage-paid Reader’s Comments forms at the end of this document request 
your critical evaluation to assist us in preparing future documentation. 


The following are trademarks of Digital Equipment Corporation: 


dlilg|iltiall TM MicroVAX TEAMDATA 
MicroVMS UNIBUS 
ACMS PDP 7 VAX 
CDD RALLY VA Xcluster 
DATATRIEVE Rdb/ELN VA Xinfo 
DEC Rdb/VMS VAX Information Architecture 
DECnet ReGIS VAX/VMS 
DECUS RSTS VMS 
Micro/RSTS RSX VT 


Micro/RSX TDMS 


How to Order Additional Documentation 


If you live in: 


New Hampshire, 
Alaska 


Continental USA, 
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(Ottawa-Hull) 
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(British Columbia) 


Canada 
(All other) 


All other areas 
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603-884-6660 


1-800-258-1710 
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1-800-267-6146 
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Digital Equipment Corp. 
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Please use this postage-paid form to comment on this manual. If you require a written reply to a software 
problem and are eligible to receive one under Software Performance Report (SPR) service, submit your 


comments on an SPR form. 


Thank you for your assistance. 


I rate this manual’s: 


Accuracy (software works as manual says) 
Completeness (enough information) 
Clarity (easy to understand) 

Organization (structure of subject matter) 
Figures (useful) 

Examples (useful) 

Index (ability to find topic) 

Page layout (easy to find information) 


I would like to see more/less 


What I like best about this manual is 


What I like least about this manual is 


I found the following errors in this manual: 


Page Description 








Excellent 


EO) Ey Eh ey. 3 


Additional comments or suggestions to improve this manual: 





I am using Version 


Name/Title 
Company 
Mailing Address 


of the software this manual describes. 


Good 


OOOOO0O000 


Fair 


OOOOO000O 


Date 


OOOOOO0O00 


Poor 
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